Radie Shaek 


~ 
TRSDOS ™-IT 
Reference Manual 


CUSTOM MANUFACTURED IN U.S.A. BY RADIO SHACK, A DIVISION OF TANDY CORPORATION 


enerer ea. ae ~ eee ee Oe oe ee ee 


ee ee 


TERMS AND CONDITIONS OF SALE AND LICENSE OF RADIO SHACK COMPUTER EQUIPMENT AND SOFTWARE 
PURCHASED FROM A RADIO SHACK COMPANY-OWNED COMPUTER CENTER, RETAIL STORE OR FROM A 
RADIO SHACK FRANCHISEE OR DEALER AT ITS AUTHORIZED LOCATION 


LIMITED WARRANTY 
|. CUSTOMER OBLIGATIONS 


A. CUSTOMER assumes full responsibility that this Radio Shack computer hardware purchased (the Equipment’), and any copies of Radio 
Shack software included with the Equipment or licensed separately (the ‘‘Software’’) meets the specifications, capacity, capabilities, 
versatility, and other requirements of CUSTOMER. 

B. | CUSTOMER assumes full responsibility for the condition and effectiveness of the operating environment in which the Equipment and Software 
are to function, and for its installation. 


ll. RADIO SHACK LIMITED WARRANTIES AND CONDITIONS OF SALE 


A. Fora period of ninety (90) calendar days from the date of the Radio Shack sales document received upon purchase of the Equipment, RADIO 
SHACK warrants to the original CUSTOMER that the Equipment and the medium upon which the Software is stored is free from manufacturing 
defects. THIS WARRANTY IS ONLY APPLICABLE TO PURCHASES OF RADIO SHACK EQUIPMENT BY THE ORIGINAL CUSTOMER FROM 
RADIO SHACK COMPANY-OWNED COMPUTER CENTERS, RETAIL STORES AND FROM RADIO SHACK FRANCHISEES AND DEALERS AT ITS 
AUTHORIZED LOCATION. The warranty is void if the Equipment’s case or cabinet has been opened, or if the Equipment or Software has been 
subjected to improper or abnormal use. If a manufacturing defect is discovered during the stated warranty period, the defective Equipment 
must be returned to a Radio Shack Computer Center, a Radio Shack retail store, participating Radio Shack franchisee or Radio Shack dealer 
for repair, along with a copy of the sales document or lease agreement. The original CUSTOMER’S sole and exclusive remedy in the event of 
a defect is limited to the correction of the defect by repair, replacement, or refund of the purchase price, at RADIO SHACK’S election and sole 
expense. RADIO SHACK has no obligation to replace or repair expendable items. 

B. RADIO SHACK makes no warranty as to the design, capability, capacity, or suitability for use of the Software, except as provided in this 
paragraph. Software is licensed on an ‘‘AS IS’’ basis, without warranty. The original CUSTOMER’S exclusive remedy, in the event of a 
Software manufacturing defect, is its repair or replacement within thirty (30) calendar days of the date of the Radio Shack sales document 
received upon license of the Software. The defective Software shall be returned to a Radio Shack Computer Center, a Radio Shack retail store, 
participating Radio Shack franchisee or Radio Shack dealer along with the sales document. 

C. Except as provided herein no employee, agent, franchisee, dealer or other person is authorized to give any warranties of any nature on behalf 
of RADIO SHACK. 

D. Except as provided herein, RADIO SHACK MAKES NO WARRANTIES, INCLUDING WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A 
PARTICULAR PURPOSE. 

E Some states do not allow limitations on how long an implied warranty lasts, so the above limitation(s) may not apply to CUSTOMER. 


NM Po fern 
We. Il. LIMITATION OF LIABILITY 

A. EXCEPT AS PROVIDED HEREIN, RADIO SHACK SHALL HAVE NO LIABILITY OR RESPONSIBILITY TO CUSTOMER OR ANY OTHER PERSON 
fers. OR ENTITY WITH RESPECT TO ANY LIABILITY, LOSS OR DAMAGE CAUSED OR ALLEGED TO BE CAUSED DIRECTLY OR INDIRECTLY BY 
fase aes “EQUIPMENT” OR “SOFTWARE” SOLD, LEASED, LICENSED OR FURNISHED BY RADIO SHACK, INCLUDING, BUT NOT LIMITED TO, ANY 
eas SS INTERRUPTION OF SERVICE, LOSS OF BUSINESS OR ANTICIPATORY PROFITS OR CONSEQUENTIAL DAMAGES RESULTING FROM THE 
\e si USE OR OPERATION OF THE “EQUIPMENT” OR ‘‘SOFTWARE”’. IN NO EVENT SHALL RADIO SHACK BE LIABLE FOR LOSS OF PROFITS, OR 
ZEN ANY INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF ANY BREACH OF THIS WARRANTY OR IN ANY MANNER 
C.F ARISING OUT OF OR CONNECTED WITH THE SALE, LEASE, LICENSE, USE OR ANTICIPATED USE OF THE “EQUIPMENT” OR “SOFTWARE”. 


NOTWITHSTANDING THE ABOVE LIMITATIONS AND WARRANTIES, RADIO SHACK’S LIABILITY HEREUNDER FOR DAMAGES INCURRED BY 

CUSTOMER OR OTHERS SHALL NOT EXCEED THE AMOUNT PAID BY CUSTOMER FOR THE PARTICULAR “EQUIPMENT” OR “SOFTWARE” 

INVOLVED. 

RADIO SHACK shall not be liable for any damages caused by delay in delivering or furnishing Equipment and/or Software. 

No action arising out of any claimed breach of this Warranty or transactions under this Warranty may be brought more than two (2) years 

after the cause of action has accrued or more than four (4) years after the date of the Radio Shack sales document for the Equipment or 

Software, whichever first occurs. 

D. Some states do not allow the limitation or exclusion of incidental or consequential damages, so the above limitation(s) or exclusion(s) may 
not apply to CUSTOMER. 


IV. RADIO SHACK SOFTWARE LICENSE 


RADIO SHACK grants to CUSTOMER a non-exclusive, paid-up license to use the RADIO SHACK Software on one computer, subject to the following 

provisions: 

_ Except as otherwise provided in this Software License, applicable copyright laws shall apply to the Software. . 

B __ Title to the medium on which the Software is recorded (cassette and/or diskette) or stored (ROM) is transferred to CUSTOMER, but not title to 
the Software. 

C. CUSTOMER may use Software on one host computer and access that Software through one or more terminals if the Software permits this 
function. 

D. CUSTOMER shal! not use, make, manufacture, or reproduce copies of Software except for use on one computer and as is specifically 
provided in this Software License. Customer is expressly prohibited from disassembling the Software. eae 

E. | CUSTOMER is permitted to make additional copies of the Software only for backup or archival purposes or if additional copies are required in 
the operation of one computer with the Software, but only to the extent the Software allows a backup copy to be made. However, for 
TRSDOS Software, CUSTOMER is permitted to make a limited number of additional copies for CUSTOMER'S own use. 

F. CUSTOMER may resell or distribute unmodified copies of the Software provided CUSTOMER has purchased one copy of the Software for each 
one sold or distributed. The provisions-of this Software License shall also be applicable to third parties receiving copies of the Software from 
CUSTOMER. 

G. _ All copyright notices shall be retained on all copies of the Software. 


Ow 


V. APPLICABILITY OF WARRANTY 


A. The terms and conditions of this Warranty are applicable as between RADIO SHACK and CUSTOMER to either a sale of the Equipment and/or 
Software License to CUSTOMER or to a transaction whereby RADIO SHACK sells or conveys such Equipment to a third party for lease to 
CUSTOMER. 

B. The limitations of liability and Warranty provisions herein shall inure to the benefit of RADIO SHACK, the author, owner and/or licensor of the 
Software and any manufacturer of the Equipment sold by RADIO SHACK. 


VI. STATE LAW RIGHTS es mn 


sae 
The warranties granted herein give the original CUSTOMER specific legal rights, and the original CUSTOMER may have other rights which vary eS 
from state to state. Fs pe 
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TRSDOS™-II Operating System: Copyright 1982 Tandy 
Corporation. All Rights Reserved. 


TRS-89® TRSDOS™-II Reference Manual: Copyright 
1982 Tandy Corporation. All Rights Reserved. 


Reproduction or use without express written permission from 
Tandy Corporation of any portion of this manual is prohibited. 
While reasonable efforts have been taken in the preparation of 
this manual to assure itS accuracy, Tandy Corporation assumes 
no liability resulting from any errors or omissions in this 
manual, or from the use of the information obtained herein. 
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About This Manual 


This manual shows how you can use TRSDOS-II to: 


‘* Store, retrieve, or manipulate information on 
disk 
‘ Use TRSDOS-II system routines within your own 


machine-language programs 


Terms 


Below is a list of terms that we use frequently in this 
manual. The underlined words represent variable information 
which you must supply. 


command represents the TRSDOS-II command you want to 
execute. 
comment is an optional field used to document the 


purpose of the command line. 


{options} is a list of one or more parameters that may 
be needed by the command. Some commands 
have no options. If you don't use a comment 


at the end of the command line, you can 
usually omit the braces { } around options. 


parameter is a variable item of information which 
customizes a command. 


filespec is a standard TRSDOS-II file specification 
having the general form: 
filename/ext.password:drive(disk name) 

TO is a delimiter (separator) which you usually 
can replace with a space. For example, 
BACKUP :@ TO :1 is the same as BACKUP :% :1l. 

hard disk refers only to a hard disk, Drives 4-7. 


diskette refers only to a floppy diskette, Drives 9-3. 
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disk refers to a disk that may be either a hard 
disk or a floppy diskette. Drives 9g-7. 


primary drive refers to the disk drive that contains the 
operating system information, Drive @ or 4, 


RAM (random access memory) is memory storage that 
can be changed (written to) as well as read. 


RAM buffer is an area in RAM for temporary data storage. 


Notations 


For clarity and brevity, we use some special notations and 
type styles in this manual. 


CAPITALS and punctuation 
indicate material that you must enter exactly as it appears 
or material that you see on your computer's video display. 


<KEYBOARD CHARACTER> 
indicates the key you press. 


lower-case underlined wT 
represent words, letters, characters or values you supply. 


X'nnnn' 

specifies nnnn as a hexadecimal (base 16) number. All 
other numbers in the text of this manual are in decimal 
(base 18) form, unless otherwise noted. 


About TRSDOS-II 


TRSDOS-II (pronounced Triss-Doss Two) is a powerful and 
easy-to-use disk operating system which provides you with a 
full set of library commands and utilities. In addition, 
many of the most useful system routines can be called 
directly by your machine-language programs. 
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Loading TRSDOS-II 


When you install and power up your computer, you see the 
TRSDOS-II startup logo. This means you are in the TRSDOS-II 
operating system. You are then prompted to enter the date. 
Enter the date in the form mm/dd/yyyy. For example, type: 


G8/25/1982 


for August 25, 1982. You are then prompted to enter the 
time. You can skip this question by simply pressing 
<ENTER>. The time starts at 99.99.99. 


If you want to set the time, type the time in the 24-hour 
format -- hh.mm.ss. The seconds are optional. For example, 
type: 


14.398 <ENTER> 
for 2:38 p.m. 


After you enter the date and time, the following prompt is 
displayed. 


TRSDOS-II Ready 


This means that you are at the TRSDOS-II command level. At 
this level you can execute a program, utility, or library 
command. 


Note: To perform any other operation, your system 
must be under the control of an application 
program. 


Tf an error occurs while the system is under the control of 
TRSDOS-II, you receive one of the error messages listed in 
Appendix B. 


If you get an error message not listed, it came from an 


application program. See the application program manual for 
an explanation of the error message. 
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Entering a Command 


You may enter a command whenever the TRSDOS-II Ready prompt 
is displayed. The command can have up to 8@ characters. 


You must capitalize all letters in a command. Therefore, 
you may find it convenient to operate the keyboard in the 
caps mode. The keyboard is in the caps mode when the <CAPS> 
light is on. Press <CAPS> to turn the light on or off. 


When in the caps mode, all alphabet keys are interpreted as 
capital letters, regardless of whether you press <SHIFT>. 
(Numeral and symbol keys remain the same. ) 


End each command by pressing <ENTER>. 
For example, type: 
CLS <ENTER> 
and TRSDOS-II clears the display. 
Note: TRSDOS-II allows key-aheads of up to 89 
characters. This means you can type in commands 
while previous ones are being executed. (The 


key-ahead is not displayed until TRSDOS-II or the 
application program is ready to interpret it.) 


Executing a Program 


You can also execute a program (such as SCRIPSIT™ or 
PROFILE™) at the TRSDOS-II Ready prompt. If what you enter 
is not a recognized command, TRSDOS-II checks to see if it 
is the name of a program. It checks for the program file on 
all the drives, beginning with the primary drive (unless you 
specify a drive number). 


If TRSDOS-II finds a matching program file, it loads and 
executes the file. Otherwise, you get an error message. 
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Disk Files 


You can keep a record of information you type into your 
computer by storing it on a disk ina "disk file." A disk 
file can contain a program, a collection of data, a project 
report you intend to make, or almost anything you want. 


When your computer stores the file, it indexes the file's 
name and disk location in a special place on the disk called 
the disk's directory. Whenever you want to access the file, 
the computer can immediately find its location by using this 
directory. 


Filespec 


When you create a disk file, you need to give it a name. 
The name is just one .part of a file specification -- 
filespec for short. 


The filespec is the standard TRSDOS-II format. It contains 
the following information: 


filename/ext.password:drive(disk name) 


filename 


The name of your file can be any you like; however, do not 
use the name of a library command or utility. The filename 
may be typed in lower case. It may be no longer than eight 
alphanumeric characters; the first character must be a 
letter. For example, if you want to save a file containing 
an inventory list, you could name it simply: 


INVNTRY 


/ext -- extension 


If you want to further identify your file, you can give ita 
second name by adding an extension. An extension is 
preceded by a slash and has one to three alphanumeric 
characters. The extension, too, may be typed in lower case. 
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You can use an extension to provide additional information 
on a file. For example, using extensions such as /NEW, 
/IRS, and /PAY, you could distinguish files that have the 
same name or divide files into categories. 


You can also use an extension to indicate the type of file 
you have. For example, you may wish to use some of the 
following: 


/BAS for BASIC programs 
JTXT for ASCII text 

/DAT for Data files 

/ OBJ LOY Object code 

/REL FOr Relocatable code 
/SRC for Source code 


If the extension /DAT is added to the inventory name, the 
filespec becomes: 


INVNTRY/DAT 


- password 


Some files let you protect them. You can give this 
protection via a password either when creating the file or 
when using the ATTRIB command. 


A password is a sequence of up to eight alphanumeric 
characters, the first of which must be a letter. A period 
(.) precedes it as a delimiter. The password may be typed 
in lower case. 


There are two levels of passwords and the protection they 
provide -- access password and update password. These 
passwords can inhibit entry to a file. In addition, the 
access password can provide various levels of protection. 


When you create a file and assign a password, the access and 
update passwords are the same. (If you do not assign a 
password, eight blanks are used.) Later, if you choose, you 
can change these passwords by using the ATTRIB command. 

This provides the additional protection to your files. (See 
the ATTRIB command for details.) 
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With the password SESAME, the new filespec of the inventory 
file is: 


INVNTRY/DAT. SESAME 


sdrive 


Often when you use your computer, you'll use more than one 
disk at a time. To speed the file access, you can specify 
the number of the drive that contains the file. The drive 
number is a number from f-7. It is preceded by a colon. 


If you omit the drive number from your filespec, your 
computer automatically starts looking for the file on all 
available drives, beginning with the primary drive. 


To indicate that your inventory program is located in Drive 
2, use the filespec: 


INVNTRY/DAT.SESAME: 2 


Refer to your hardware's owner's manual for information on 
your drive numbers. 


(disk name) 


You may want to indicate the name of the disk on which the 
file is stored. The disk name was assigned when you 
formatted or backed up the disk. 


The disk name is a field of up to eight alphanumeric 
characters, the first of which is a letter. Parentheses ( ) 
Surround the name. If you specify the disk name, you must 
also specify the drive number. 


By adding the disk name WREHSE to the inventory program, you 
form the filespec: 


INVNTRY/DAT .SESAME: 2 (WREHSE ) 
Of course, every filespec you enter won't include all of 
these optional specifications. However, you can use any 


combination of the fields as long as you follow the 
guidelines described above. 
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Here are more examples of valid TRSDOS-II filespecs: 


DOPROG .OPEN 
CLR/BAS:1 
COMPTR:@(OPRSYS ) 
DEPT69/TXT. BOSS: 4( PAYROLL ) 
GAMES :1 
THESIS/OLD:2 
TEST /CMD 


Wildcard 


Certain commands and supervisor calls 
a collection of files by using a "wildcard" mask. 


(SVCs) let you specify 


An 


asterisk (*) in a file specification represents a wildcard 
field and means "any sequence of zero or more characters." 
For example: 


* /BAS:1 


represents all the files stored on the diskette in Drive l 
that have the extension /BAS. 


D* 


represents all the files stored on the disk in the primary 


drive that begin with D and do not have extensions. 
if you want a directory of all the files that begin 


example, 


with the letter D and have an extension, 


DIR D*/* <ENTER> 


type: 


For 


TRSDOS-II returns a listing of all the files beginning with 
D and having extensions: 


Disk Name:TRSDOS 


File Name 


DECRPT/BAS 
DATASALE/BAS 
DANTE/BAS 
DEF /DTA 
DISBRK/CMD 
DIR/EFC 


Created 
MM/DD/YY 
94/28/82 
94/28/82 
94/28/82 
19/15/89 
19/39/89 
§8/14/89 


6 Files Displayed 


Drive:4 


Updated 
MM/DD/YY 
94/28/82 
94/28/82 
$ 4/28/82 
94/28/82 
93/93/82 
91/29/82 


Atrb 


D*X@ 
D*Xg 
D*Xg 
D*X9 
P*XP 
P*XG 
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99/38/82 
Rec # of 
Len Records 
256 55 

64 19d 
256 39 
255 12 
256 1 
256 4 


90.27.18 
~-——Sectors——-- 


Alloc 
55 

26 

39 

12 

1 

4 


Used 
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Super Wildcard 


Besides the wildcard (*), TRSDOS-II has a super wildcard 
(!). You can use it to specify all files, with and without 
extensions. 


For example, you may want to FCOPY from a diskette to hard 
disk all files, regardless of whether they have extensions. 
Using the wildcard, you must give two FCOPY commands: 


FCOPY */*:1 TO 4 <ENTER> 
FCOPY *:1 TO 4 <ENTER> 


The first command copies files with extensions. The second 
then copies files without extensions. 


If, however, you use the super wildcard and type: 
FCOPY !sl TO 4 <ENTER> 


you can do the entire FCOPY in one step. MTRSDOS-II copies 
all Drive 1 files to the hard disk. 


You can use the wildcard and super wildcard with these 
commands: 


DIR FCOPY 
FILES KILL 
MOVE 
® 
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How to Use This Section 
This section contains an alphabetical listing of all 
TRSDOS-II commands and utilities. 


Commands 


Commands are system operations that do not use user memory. 
You can use commands from within programs. 


To see a list of all commands, use the LIB command. Type: 
LIB <ENTER> 
and the following list is displayed: 


TRSDOS-II Ready 


LIB 
AGAIN ATTRIB AUTO CLEAR CLICK CLS DATE DEBUG DIR DO 
DUAL ECHO ERROR FC FLOPPY FORMS FREE HOST I KILL 


LIB LOAD PAUSE PROT PURGE RENAME RESET SCREEN SETCOM SPOOL 
STATUS TIME oe VERIFY 

Utilities 

Utilities use some or all of user memory. They return to 
TRSDOS-II Ready; you cannot use them effectively within 


programs. 


The utilities are: 


APPEND BACKUP BUILD COPY CREATE DRIVE 
DUMP FCOPY FILES FORMAT HELP LIST 
MEMTEST MOVE PATCH PRINT RECEIVE RESTORE 
SAVE TERMINAL 


Entry Organization 


Fach entry in this section is identified as either a command 
OY @ ULL ty: 
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The "syntax" is the first line you see after the keyword. 
Use it as your guide to type in a command. (See "Syntax" 
below for details.) 


A definition of the command or utility follows the Syntax. 
This definition tells you exactly what the command or utility 
does. 


Next, the entry includes additional information on the 
parameters of the command. A command may require you to 
supply some values. It also may offer several "options" that 
customize the command to your needs. Values and options are 
discussed in the additional parameter information. 


Further explanation of the command follows the parameter 
information. This explanation includes special instructions 


on the command and switches and tells how best to use the 
command for your purposes. 


Finally, each entry gives examples of the command's use. 


Syntax 


The command's syntax tells you what format to use when you 
type the command. 


For example, the syntax for the CLS (Clear Screen) command is 
simply: 


CLS 
CLS <ENTER> is all you type to execute this command. 


The syntax for the KILL command includes an additional 
parameter (a value you supply): 


KILL filespec 


The value is indicated by lower-case underlined. [In this 
case, it is a TRSDOS-II filespec. For example, if you want 
to kill the disk file named SAMPLE in Drive 1, you type: 


KILL SAMPLE:1 <ENTER> 
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The COPY command has even more parameters: 
COPY source filespec to destination {option} 


Here, you must supply the name of the source filespec you 
wish to copy and the destination to which you want it copied. 
For example: 


COPY NEW/DAT:1 TO NEWDAT/1:2 <ENTER> 


copies the Drive 1 file NEW/DAT onto the diskette in Drive 2; 
names the new file NEWDAT/1. 


Sometimes the additional information is required, as are the 
filespecs in the above examples. Sometimes a command offers 
several options. These are indicated in braces and may be 
either optional or required. The text tells you which are 
required. The COPY example above has one option: 


{ABS } 


When typing the COPY command, you must decide if you need 
this option. (ABS tells TRSDOS-II to overwrite any existing 
file if it has the same name as the destination.) If you | 
need it, type: 


COPY NEW/DAT:1 TO NEWDAT/1:2 ABS <ENTER> 


Unless you include a comment or omit a second, optional 
filespec, you usually can omit the braces. 


Although the variable comment is not included in every syntax 
statement, you may add one at any time. Comments are for 
your information only. For example: 

COPY NEW/DAT:1 TO NEWDAT/1:2 {ABS} Latest version 


documents the purpose of the COPY command. 


You may want to use the comment if you are calling the 
command from a DO file (see the DO command) or a program. 


Every command uses some variation of the syntax forms 
discussed above. The command entry will help you decide 
which values and options to use. 
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AGAIN Library Command 
AGAIN 


Re-executes the most recently entered command. 
You cannot use AGAIN after certain library commands, 
utilities, and user programs. For example, you cannot use 
it after FCOPY {DIR}. 
Example 
If you just executed the command: 
TIME <ENTER> 
type: 
AGAIN <ENTER> 


to re-execute it. 
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APPEND Utility Program 
APPEND source filespec TO destination 


Copies the contents of the source filespec onto the end of 
the contents of the destination. (The contents of the 
source file remain the same. ) 


The destination can be a filespec or drive number. 


If the destination is a drive number, TRSDOS-II appends 
only if the drive contains a disk file with the same name as 


the source filespec. 


The types of the two files must match. Both must contain 
variable-length records (VLRs) or both must contain fixed- 
length records (FLRS). (See "Record Length" in the 
"Technical Information" section. ) 
You cannot use the APPEND command with ISAM files (indexed 
access files used by some compilers, such as the COBOL 
compiler) or TRSDOS-II DO files. 
Examples 

APPEND WORDFILE/2 TO WORDFILE/1 <ENTER> 


copies the contents of WORDFILE/2 onto the end of 
WORDFILE/1. 


APPEND REGION1/DAT TO TOTAL/DAT.GUESS <ENTER> 


appends REGION1/DATA to TOTAL/DAT, which is protected by the 
password GUESS. 


Radie Shaek 


2/6 


TRSDOS-II ‘5 REFERENCE MANUAL 
TRS-8O 


ATTRIB Library Command 


ATTRIB filespec {options} 


Assigns or changes the password and protection level of a 


filespec. 


When you create a file, you may specify one password. 
TRSDOS-II assigns this as both the access password and the 
update password. 


The access password limits your file access to operations 
such as read and execute. 


The update password gives you total file access -- the 
authority to do all file operations, including change, 
rename, and kill. 


If the access and update passwords are the same, you have 
total access. (See "Filespec" in the "Introduction" for 
further explanation of passwords.) 


ATTRIB divides file access. It lets you assign two 
passwords; it also lets you assign different levels Of 
protection to the access password. 


The options are: 
ACC=password sets the access password. If you omit 


this option, the access password stays the same. 
UPD=password sets the update password. Tf you omit 
this option, the update password stays the same. 
PROT=level sets the access protection level. If you 
omit this option, the level stays the same. The 
optional protection levels for access to a file 


are: 

NONE No access 

EXEC Execute only 

READ Read and execute 

WRITE Read, execute, and write 

RENAME Rename, read, execute, and write 

KILL Kill, rename, read, execute, and write 


(gives the access password total access) 
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The access password, which protects the file's contents at 
the level set by PROT, could be for the operator. For 
example, if the protection level is READ, the operator can 
only read and execute the file. 


Similarly, the update password could be for the programmer. 
When the update password is used, TRSDOS-II ignores the 
protection level and gives the programmer total access. 
Examples 


ATTRIB DATAFILE ACC=JULY14, UPD=MOUSE <ENTER> 


sets the access password to JULY14 and the update password 
to MOUSE. The protection level remains at the previous 
level. 


ATTRIB PAYROLL/BAS.PW PROT=EXEC <ENTER> 


leaves the access and update words unchanged, but changes 
the protection level to EXEC (execute). 


ATTRIB DATAFILE/1.PRN UPD=OPEN PROT=READ <ENTER> 


sets the update password to OPEN and the protection level to 
READ. 
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AUTO Library Command 
AUTO command line 


Stores the command line, which executes automatically 
whenever you start up TRSDOS-II. (After you enter the date 
and time, TRSDOS-II loads and executes the command. ) 


The command line is optional. It can be a TRSDOS-II 
command or the name of an executable program file. If you 
omit the command line, TRSDOS-II simply deletes the auto 
command line currently stored. 


When you enter the auto command line, TRSDOS-II does not 
check it for errors. Errors are detected when the command 
executes. 


To override a set auto command line, press <HOLD> before or 
after you enter the date when you start up the system. 


Examples 
AUTO DIR {SYS} <ENTER> 


executes the command DIR {SYS} at startup and then displays 
TRSDOS-II Ready. 


AUTO BASIC <ENTER> 


executes BASIC. 
AUTO DO DRIVESET <ENTER> 


executes the command file named DRIVESET. (See the BUILD 
and DO commands for details on creating and executing 
command files.) 

AUTO <ENTER> 


turns off the auto command currently stored. 
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BACKUP Utility Program 
BACKUP drivel TO drive2 {options} 


(FOR FLOPPY DISKETTE USE ONLY) 

Makes an exact, mirror-image copy of the source diskette in 
floppy drivel to the destination diskette in floppy 

drive2. 


If the destination diskette is unformatted, the BACKUP 
utility formats it before copying. 


To use BACKUP, you must have at least two floppy drives 

(drivel and drive2 cannot be the same drive number). If 
you don't have at least two floppy drives, use the COPY 

command. 


The options are: 


ID=diskette-name assigns the name of the new 
diskette. If you omit this option, TRSDOS-II 
gives the new diskette the same name as the source 


diskette. 
PW=source-password indicates the master password of 
the source diskette. TRSDOS-II duplicates a 


diskette only if you give the correct password or 
if PW=PASSWORD. (All disks distributed by Radio 
Shack use PASSWORD as the default master 
password.) If PW does not equal PASSWORD and you 
do not give the correct password, backup aborts 
with an error. 

NEW=destination-password assigns the password of 
the new diskette. If you omit this option, 
TRSDOS-II uses the password of the source 
diskette. 

ABS overwrites, without prompting, any data already 
on the destination diskette. If you omit this 
option, TRSDOS-II prompts you before overwriting. 


By uSing BACKUP to duplicate your TRSDOS-II diskette, you 
can create another operating system diskette. 


We suggest that you make copies of all your diskettes -- 
especially your system diskette -- and store your originals 
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in a safe place. This reduces the possibility of losing 
important information should something happen to the 
diskette you are using. 


If you try to back up a single- to a double-sided diskette, 
TRSDOS-II performs the backup automatically. If you try to 
back up a double- to a single-sided diskette, however, an 
error occurs. 


Examples 
BACKUP @ TO 1 <ENTER> 


makes an exact, mirror-image copy of the diskette in Drive 9 
to the diskette in Drive l. 


BACKUP @ TO 3 {ID=ACCTDISK NEW=MAY24} <ENTER> 


copies the diskette in Drive @ to the diskette in Drive 3; 
names the new diskette ACCTDISK and assigns it the master 
password MAY24. 


BACKUP 1 TO @ <ENTER> 


copies a data diskette in Drive 1 to a diskette in Drive g. 
After entering this command, you are prompted to remove the 
system diskette and place your destination diskette in 
Drive @. 
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BUILD Utility Program 


BUILD filespec 


Creates or lets you edit a DO file, an automatic command 
input file which contains one or more library commands, 
utilities, or programs. You can execute the DO file with 
the DO command. 


The filespec may not include an extension. 


Creating a Do File 


When you enter the BUILD command with a non-existing 
filespec, BUILD creates the file and then prompts you to 
begin inserting lines: 


Enter Command Line (1-89) 


At this prompt, you can enter a command line of up to 89% 
characters. 


Or, to end the file, simply press <ENTER> at the prompt. 


Pressing <BREAK> also ends the file, but it omits the last 
line in the file, unless you end that line with a carriage 
return. 


Example 

To create a new file named COPYSCR, type: 
BUILD COPYSCR <ENTER> 

TRSDOS-II displays the command line prompt: 


Enter Command Line (1-89) 


Answer the prompt by typing: 


COPY NEWFILE/LST:4 TO @ <ENTER> 
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to command TRSDOS-II to copy NEWFILE/LST from Drive 4 to 
Drive @ whenever you type DO COPYSCR. 


TRSDOS-II then asks if you want to: 
Store Line? (cr/esc) 


If you wish to store the line and continue building the 
file, press <ENTER>. If you do not wish to store the line, 
press <ESC>. In this case, press <ENTER>. 


Now, type and store these command lines as you did the 
First: 


COPY DIRECTRY/NME:4 TO @ 
COPY TRANSFER/ACT:4 TO @ 
PAUSE "INSERT DISK 9" 
<ENTER> 


The last line tells TRSDOS-II that you have finished 
entering command lines. TRSDOS-II displays the prompt: 


kkkkKKKK Edit Complete ******x** 
and returns to TRSDOS-II Ready. 
Now, whenever you type: 
DO COPYSCR <ENTER> 
TRSDOS-II executes the file by copying the files from the 
diskette in Drive 4 to the diskette in Drive @. Then, it 
pauses, displaying the message: 


PAUSE "INSERT DISK 9" 
Press any Key to Continue 


Editing a Do File 
When you enter the BUILD command with an existing 


filespec, TRSDOS-II copies the file into a new file with 
the same name and the extension /OLD. Then, you can edit 


the file. 
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Example 
To edit the file you created, type: 
BUILD COPYSCR <ENTER> 


TRSDOS-II displays the first command line and the edit 
prompt: 


COPY NEWFILE/LST:4 TO @ 
Keep, Delete, Fix, Replace, Insert, or Quit? 
Enter {h,;D-F -RelsOlsexx 


This prompt allows the following options: 
KEEP Copies the line, as is, into the new file. 


DELETE Deletes the line by not copying it into the 
new file. 


FIX Lets you edit the line. (For details on FIX, 
see the FC command. ) 


REPLACE Deletes the displayed line and lets you 
insert replacement lines. Press <ENTER> at 
the beginning of a line to stop replacing. 


INSERT Lets you insert lines ahead of the line being 
displayed. Press <ESC> to erase errors in 
the insert line. 


QUIT Ends the editing session. 


Type K <ENTER> to keep the first line, as is, and display 
the second line for editing. 


COPY DIRECTRY/NME: 4 TO @ 
To delete this line, type D <ENTER>. The message **Line 
Deleted from File** appears. TRSDOS-II displays the next 
line for editing: 


COPY TRANSFER/ACT:4 TO @ 


To "fix" the line, type F <ENTER>. TRSDOS-II displays the 
line, with the cursor positioned over the first character. 
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Press <right arrow> to move the cursor to where you want to 
make the change. Change the extension to LGR, by typing LGR 


over ACT. After making the change, press <ENTER> once to 
move the cursor to the beginning of the line. 


Press <ENTER> again to store the new line in the file. 

Type Q <ENTER> to quit the session. TRSDOS-II prompts: 
**kEND OF FILE -- Add to EOF (Y/N)?** 

Type Y <ENTER> if you want to add lines to the end of the 


BUILD file. If you do not want to add lines, type N 
<ENTER>; TRSDOS-II Ready is displayed. 
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CLEAR Library Command 
CLEAR 


Clears user memory and returns to TRSDOS-II. It does not 
re-initialize the input/output (I/O) drivers or protected 
high memory. 

Example 


CLEAR <ENTER> 
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CLICK Library Command 
CLICK {switch} 
Turns the key entry sound on or off for those computers that 
Support sound. 
The switch options are: 
ON turns on CLICK 
OFF turns off CLICK 
Example 
CLICK ON <ENTER> 
causes the computer to generate sound whenever you press 


certain keys. <CTRL>, <CAPS>, <LOCK>, <SHIFT>, and <REPEAT> 
do not generate sound. 
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CLS Library Command 
CLS 

Clears the display and positions the cursor at the upper 

left corner of the display. 


Example 


CLS <ENTER> 
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COPY Utility Program 
COPY source filespec TO destination {ABS} 


Copies the source filespec to the destination. 
The destination can be a filespec or drive number. 


If you specify a filespec as the destination, TRSDOS-II 
checks to see if the destination already exists. If the 
file does not exist, TRSDOS-II creates it (on the specified 
or first available drive). 


If you specify only the drive number as the destination, 
TRSDOS-II copies the source filespec to the disk in that 
drive. It gives the destination file the same name as the 


source filespec. 


ABS is optional. If you include ABS, TRSDOS-II overwrites 
without prompting any non-protected, existing file that has 
the same name as the destination. If you omit ABS, 
TRSDOS-II prompts you before overwriting. 


Normally, COPY uses memory below X'39@@'. However, when 
copying from one diskette to another ina single drive, it 
uses memory up to the beginning of unprotected memory (see 
"Memory Requirements" in the "Technical Information" 
section). 


Examples 
COPY OLDFILE/BAS:3 TO NEWFILE/BAS:2 <ENTER> 


copies OLDFILE/BAS from the diskette in Drive 3 to the 
diskette in Drive 2 and names the new file NEWFILE/BAS. 


COPY NEW/DAT TO DEFUNCT/DAT:2 ABS <ENTER> 
searches for NEW/DAT and copies the file (from the first 
drive that contains it) to DEFUNCT/DAT in Drive 2. If you 


already have a disk file named DEFUNCT/DAT in Drive 2, 
TRSDOS-II overwrites it with the new file. 
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COPY FILE/A:4 TO FILE/B:1(DOUBLE) <ENTER> 


copies FILE/A from the diskette in Drive 4 to the diskette 
in Drive 1 and names the new file FILE/B. 


COPY TESTPROG TO 3 <ENTER> 
searches for TESTPROG and copies the file from the first 


drive that contains it to the diskette in Drive 3. It names 
the new file TESTPROG. 
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CREATE Utility Program 


CREATE filespec {options } 


Creates a file named filespec and pre-allocates space for 
its contents. If you use CREATE, TRSDOS-II does not 
de-allocate (recover) unused space when you close the file. 


If you do not use CREATE, TRSDOS-II allocates space for your 
file dynamically as you write to it. Then, when you close 
the file, TRSDOS-II de-allocates the unused space. 


The options are: 

NGRANS=number allocates number * 5 sectors to 
the file. For example, if you want to allocate 
19@ sectors to the file, set NGRANS to 20. 

NRECS=number assigns the specified number of 
fixed-length records to the file. If you use 
this option, you must also use the LRL= Opc1ONn. 

LRL=number (used only with the NRECS= option) 


RSE PELL EISLER AL ALBEDO LILLIA 
8 


assigns number as the logical record length. 

The number can be from 1-256. If you omit this 

option, the record length defaults to 256% 
TYPE=V specifies the record type as variable-length. 
TYPE=F specifies the record type as fixed-length. 

If you omit both TYPE= options, TRSDOS-II uses 

TYPE=F. (The extended mode does not apply to 

CREATE. ) 


NGRANS and NRECS are mutually exclusive. If you use NGRANS, 
do not use NRECS. If you use NRECS, do not use NGRANS. 


(For more information about record lengths and types, see 
"Disk Files" in the "Technical Information" section.) 


Examples 
CREATE DATAFILE/BAS NRECS=39@,LRL=256 <ENTER> 


creates a file named DATAFILE/BAS and allocates space for 
3088 256-byte fixed-length records (FLRS). 
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CREATE TEXT/1 NGRANS=10@,TYPE=V <ENTER> 


creates a variable-length record file (VLR file) named 
TEXT/1 and allocates 5@@ sectors to it. 


CREATE NAMES/TXT.IRIS NRECS=599%,LRL=3% <ENTER> 


creates an FLR file named NAMES/TXT, which is protected by 
the password IRIS. The file can hold 5@@ 3f-byte records. 
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DATE Library Command 


DATE {mm/dd/yyyy} 


Resets the date or displays the date and time string. 


You first set the date when you start up your computer. 
DATE lets you change it without resetting your computer. 


mm/dd/yyyy is optional. Use it to reset the date. mm is 
a 2-digit month specification; dd is a 2-digit day of the 
month specification; yyyy is a 4-digit year specification. 
If you omit this option, TRSDOS-II displays the current date 
and time. 
Examples 

DATE <ENTER> 
displays the current date and time as: 


Thu Jul 1 1982 182 -- 14.55.95 


for Thursday, July 1, 1982, the 182nd day of the year, 
2:55:85 p.m. Note that leading zeroes are not displayed. 


DATE @8/21/1982 <ENTER> 


resets the date to August 21, 1982, and displays the new 
information. 
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DEBUG Library Command 
DEBUG {switch} 


Sets up the debug monitor which lets you enter, test, and 
debug machine-language programs. 


The switch options are: 
ON turns on DEBUG 
OFF turns off DEBUG 


The switch is optional. If you omit it when DEBUG is off, 
TRSDOS-II returns the status DEBUG. If you omit it when 
DEBUG is on, TRSDOS-II enters DEBUG. 


While DEBUG is on, you automatically enter the debug monitor 
whenever you load and execute a user program. In this mode, 
you can enter any of a special set of single-key commands to 
study how your program is working. 


DEBUG loads into the high-memory area sometimes reserved by 
TRSDOS-II for special programming. (See "Memory 
Requirements" in the "Technical Information" section. ) 
While DEBUG is on, TRSDOS-II automatically protects this 
area from being overlaid by BASIC or other user programs. 


You can use DEBUG only on programs in the user area X'289f' 
to TOP. (See the STATUS command to locate TOP.) 


To use DEBUG from BASIC, you must turn on DEBUG before you 
start BASIC. 


Examples 

DEBUG ON <ENTER> 
turns on DEBUG (loads it into high memory, protects high 
memory, and sets up a "scroll window" -- a block of lines 
that is to be scrolled). The lower 11 lines of the display 
make up the scroll window. The upper 13 lines contain the 
debug monitor display. 


DEBUG OFF <ENTER> 


turns off DEBUG and removes protection of high memory. 
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DEBUG <ENTER> 


enters DEBUG if it is on; returns the status of DEBUG if it 
1S Et; 


To Enter the Debug Monitor 
To enter the monitor when DEBUG is off, type: 


DEBUG ON <ENTER> 
DEBUG <ENTER> 


To enter the monitor when DEBUG is on, do one of the 
following: 


‘ Type DEBUG. TRSDOS-II enters the debug monitor. 
‘ Load a user program by typing its filespec. 


TRSDOS-II loads the program and enters the debug 
monitor. The transfer address for the program is 
in Register PC's display. 


ASCIll display— 
Start address of one RAM display—shows period “.” indicates 
16-byte “row” of RAM. hex contents of each a non-displayable 
byte. character. 


Z-88A Register Contents & RAM Display. SZHPNC are the flag 
bits in Register F. 
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The ? is the command prompt; it indicates that you can enter 
one of the single-key commands. Press <H> (for “help") to 
display a "menu," a list of DEBUG commands. To enter one of 
the commands, press the letter you see capitalized in the 
command menu. For example, to enter the memory command 
"raM," press <M>. 


Most commands prompt you to enter additional information or 
subcommands. While entering commands and subcommands, 
you'll find the following keys useful: 


<ESC> Returns to the ? prompt and cancels the 
current command 


<BACKSPACE> Backspaces the cursor and erases the 
previous character 


<left arrow> Backspaces the cursor without erasing 
characters 


<right arrow> Moves the cursor forward without erasing 
characters 


<Fl1> Positions the cursor at the starting memory 
address when used with certain subcommands 


<TAB> Tabs the cursor when used with certain 
subcommands 


Command Description 

B (Breakpoint) 

When execution reaches a breakpoint which you have set ina 
program, control returns to the debug monitor, and the 
program counter points to the breakpoint address. 

Press <B> to set a breakpoint. Place the breakpoint at the 
beginning byte of an opcode -- never in the middle of an 
instruction. 

TRSDOS-II prompts you to enter the breakpoint number. You 


can enter up to eight breakpoints, so type in a number from 
1. ES Bs 


Radie Shaek 


2/26 


TRSDOS-II n REFERENCE MANUAL 
TRS-8O 


Next, TRSDOS-II prompts you to enter the new address for 
that breakpoint. If the breakpoint is already set, 
TRSDOS-II displays the old breakpoint address, and the 
original instruction that goes in that address. 


While a breakpoint is in place, the memory display for the 
breakpoint address shows X'D/7'. 


For example: 
? B #=1 A=2899 


puts a breakpoint (#1) at address X'289%'. The memory 
display for X'289@' shows X'D7'. 


X’D7’ indicates a breakpoint 
has been set at this address. 


To delete a single breakpoint without affecting any others, 
press <ENTER> instead of providing a new address for the 
breakpoint. 


Cc (Continue) 


After the debug monitor has stopped at a breakpoint, press 
<C> to resume execution of your program at the address 
pointed to by PC. The original instruction at the 
breakpoint address executes, but the breakpoint remains in 
place. 
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D (Decimal Format) 


Press <D> to display all addresses in decimal form. 
(TRSDOS-II still displays the contents of all registers and 
memory addresses in hexadecimal.) In the decimal display 
format, you must enter all addresses as 5-digit decimal 
numbers. 


E (Empty Breakpoint Table) 


Press <E> to delete all breakpoints. MTRSDOS-II restores all 
breakpointed instructions. 


F (Find Hex String) 
Press <F> to search in memory for a string of up to 29 
bytes. DEBUG prompts you to type in the start (S=) and end 
(E=) addresses of the area to be searched. It also prompts 
you for the data (D=) for which to search. 
Type in the search string in hexadecimal format, then press 
<ENTER>. The debug monitor displays the first occurrence of 
the string. If the string is not in the search area, the 
current memory display stays the same. 
Example 

? F S=2899 E=499G D=C39977HW <ENTER> 


searches memory from X'28@@' through X'49@M' for the 3-byte 
hexadecimal string X'C39979'. 


X (Hex Format ) 

Press <X> to return the display to hexadecimal format. [In 
this mode, you must enter all addresses as 4-digit 
hexadecimal numbers. 

J (Jump) 

Press <J> to load the "jump" address into Register PC. 


This is a 2-step process: 


ig Press <J> and type in the jump address. This 
loads the address into Register PC. 
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he Press <C> to continue execution at that point. 
For example, type: 
? J A=2809 
then press <C> to start execution at X'2899'. 
L (Load or Copy Memory to Memory) 
Press <L> to copy a block of memory. DEBUG prompts you to 
type in the start (S=) and end (F=) addresses of the block 
to be copied and the destination address (T=) for the first 
byte to be copied. 
The copy is incremental. DEBUG copies the first byte to the 
first destination address, then the second byte to the 
second destination address, and so on. 
Examples 
2? L S=2890 E=28FP T=3 009 
i ' copies from addresses X'28908' through X'28FM/' into memory at 
X'399@G' through X'39FP'. 
You can use this command to fill memory with a specific 
value. Put the desired value in address nnnn and use a 
command such as this: 
? L S=nnnn E=xxxx T=nnnn + 1 
This copies the value in nnnn into every location from 
nnnn + 1 to xxxx. For example, if x'289' contains 
X'2¢0', then: 
? L S=2890 E=3999 T=2891 
fills memory from X'28f1' to X'399G' with X'2¢'. 
O (Debug Off) 
Press <O> to exit the debug monitor and turn off DEBUG. All 
breakpoints are removed from your program, and DEBUG returns 
to TRSDOS-II. If you want only to exit DEBUG, press <5? 
DEBUG remains "on." 
-_ 
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P (Print Display) 
Press <P> to send a copy of the display to the printer. 
M (Examine and Change Memory) 


Press <M> to enter this command. DEBUG prompts you to type 
in the starting address of memory to be examined. AS soon 
aS you type in the complete address, the memory display 
shows the 128-byte area that starts at that address. 


While the A= prompt is present, you can scroll through 
memory 64 bytes at a time by pressing <ENTER>. The up and 
down arrows move the cursor in 128-byte increments. 


To modify any memory in the display area, press <Fl> while 
the A= prompt is displayed. The cursor moves up into the 
memory display area. 


When the cursor is in the hexadecimal area, enter 
hexadecimal values. DEBUG updates the memory display as you 
type in each nibble (hexadecimal character, half a byte). 


When the cursor is in the ASCII area, enter ASCII 
characters. Press </> to return to hexadecimal entry. 


To cancel all changes in memory, press <ESC>. To effect 
all changes, press <F2>. 


R (Modify Registers) 
Press <R> to change a register pair. The R=> prompt 


appears. Type in a letter indicating which register pair 
you want to change: 


A EOF AF B for BC D tor -DE H for HL 
KX tor I ¥ tor Zy 
FEF ter AF" tor “BC* B tor pe ty Tor Hy" 


The cursor moves to the first byte of the register pair. 
While in the register modify mode, use the cursor control 
keys <right arrow> and <left arrow> to move over one nibble 
at a time. Use <TAB> to advance to the next register pair. 


To cancel changes in register contents, press <ESC>. To 
effect changes made, press <F2>. 
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S (System) 

Press <S> to return to the TRSDOS-II Ready mode. DEBUG is 
Still on; when you load and execute a program, you again 
enter DEBUG. 

While the cursor is in the memory display area, the cursor 


control keys are: 


<F1l> Homes the cursor 
<TAB> Tabs the cursor 
<ENTER> Moves the cursor to the start of the next row 
LJ > Moves the cursor in and out of the ASCII area 
Moves the cursor: 
<up arrow> up 
<down arrow> down 
<left arrow> left 
<right arrow> right 
® 
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DIR source {options} 


REFERENCE MANUAL 


Library Command 


The source can be a standard TRSDOS-II filespec, a 


wildc 


ard, 


or a drive number 


(§-7). 


number, TRSDOS-II goes to the primary drive. 


The options are: 
PRT sends the directory listing to the printer. 


you omit this option, TRSDOS-II displays the 


directory on the screen. 


SYS lists system files. 


TRSDOS-II displays only user files. 


If you omit this option, 


If you omit the drive 


Disk Name:TRSDOS Drive:4 99/38/82 00.27.18 
File Name Created Updated Atrb Fil Rec #of $=----Sectors---—- 
MM/DD/YY MM/DD/YY Typ Len Records Alloc Used 
DES IGN2 92/18/82 92/18/82 P*x~ F 256 2 2 2 
SAMPPROG @1/@1/81 12/28/81 D*x®@ V +t bet 4 4 
SAMPPROG/BAS 91/91/81 12/28/81 D*x®? V ++ e+ 7 7 
OLDFILE @1/91/81 91/84/82 D*xo F 19 20 8 8 
NEWF ILE 01/91/81 12/28/81 D*x? F 196 20 9 9 
HOLD 18/29/88 4/28/82 D*x® F 256 6 6 6 
ABC/DTA 11/83/81 94/28/82 D*x®@ F 255 +++ 4) t+ 
RDTEST4 11/93/81 94/28/82 D*x@ F 256 6 6 6 
8 Files Displayed 
What the Column Headings Mean 
Disk Name -- The name assigned to the diskette when it 
was formatted or backed up. 
‘ File Name -- The name and extension assigned to a file 
when it was created. 
‘ Creation Date -- The date on which the file was 
created. 
® 
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‘ Update Date -- The date on which the file was last 
updated. 
- Attributes -- A 4-character field which lists the 


file's attributes: 


The first character is either P for “program file" or D 
for “data file." 


The second character is either S for "system tile" or > 
for "user file." 


The third character gives the password protection 


status. 
X The file is unprotected (has no passwords). 
A The file has an access word only. 
U The file has an update word only. 
B The file has both update and access words. 


The fourth character specifies the level of access 
assigned to the access word: 
0,1 Kill, rename, read, execute, and write 
Rename, read, execute, and write 
Not used 
Read, execute, and write 
Read and execute 
Execute 
No access 


~] OV O1 &m W DO 


See the ATTRIB command for an explanation of how to 
change the access password, update password, and 
protection level. 


és File Type -- Indicates the record type for the file: 
F Fixed-length records 
V Variable-length records 


Record Length -- The length assigned when the file was 
created (applies only to FLR files). Plus signs (+) 
indicate a VLR file. 


Number of Records -- The number of logical records that 
have been written. Plus signs (+) indicate that none 
has been written or that the file has variable-length 
records, so the number cannot be calculated. 
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‘ sectors Allocated -- The number of sectors (256-byte 
blocks) allocated to the file. 

é sectors Used -- The number of sectors to which data has 
been written. Plus signs (+) indicate the file has no 
data. 

‘ Files Displayed -- The number of files on the directory 
Listing « 

Examples 


DIR <ENTER> 


displays the directory of the user files (that are on the 
disk) in the primary drive. 


DIR 1 {SYS,PRT} <ENTER> 


lists, to the printer, the directory of the system files in 
Drive l. 


DIR */BAS:1 <ENTER> 


displays the directory of the user files in Drive 1 that 
have the extension /BAS. 


DIR B*/* <ENTER> 


displays the directory of the files that are in the primary 
drive, start with the letter B, and have extensions. 


DIR B* <ENTER> 


displays the directory of the files that are in the primary 
drive, start with the letter B, and do not have extensions. 


DIR ! <ENTER> 


displays the directory of all files, with or without 
extensions, that are in the primary drive. 
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DO Library Command 


DO filespec 


Executes a DO file, an automatic command input file that 
contains one or more library commands or programs. 
TRSDOS-II executes the commands as if you had typed them in 
from the keyboard. 


You can create a DO file with the BUILD command. Command 
lines in this file may include library commands or file 
specifications for user programs. 


You cannot include the DEBUG command in a DO file. 


Also, you cannot execute a DO file and the SPOOL command at 
the same time. The first one executed has priority over the 
second. 


Running User Programs from a DO file 


Besides executing TRSDOS-II library commands, you can load 
and execute user programs from a DO file. When you do so, 
enter your program name as the last line in the DO file. 


For example, to perform some library commands and then run a 
BASIC program called MENU, enter this as the last line in 
your program: 


BASIC MENU <ENTER> 


You can "chain" DO files by putting another DO command at 
the end of a DO file. 


In addition, you can run user programs from the middle of a 
DO file. Your program runs normally. Your program must 
return to TRSDOS-II for the execution of the DO file to 
continue. If, however, you press <BREAK> during program 
execution, your program ends and control returns to 
TRSDOS-II. 
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Examples 
DO STARTER <ENTER> 

begins automatic command input from STARTER. 
AUTO DO STARTER <ENTER> 


sets DO STARTER as the auto command file. Whenever you 
start up, TRSDOS-II first executes the command file STARTER. 
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DRIVE Utility Program 


DRIVE drive {options} 


Lets you: 

‘ Gain the best use of a floppy disk drive by 
changing the following disk drive settings: 
a) seek rate (the rate at which the computer is 

able to access the diskette 

b) diskette swap detection 
c) wait (for a drive ready condition) 

é Turn secondary floppy or hard disk drives 


off-line 


If you omit all options, DRIVE returns the current settings 
for the specified drive. 


The following information offers a thorough explanation of 
the DRIVE command and all its options. Please read it 
before using this command. 


The options are: 
RATE=number (used for floppy drives only) Sets 
the seek rate of the floppy disk drive. The 
number is from @-3 where: 


@ = 3 milliseconds 
1 = 6 milliseconds 
2 = 18 milliseconds 
3 = 15 milliseconds 


RATE is optional. If you omit RATE, the setting 
stays the same. 

DETECT (used for floppy drives only) sets the 
diskette swap detection. This causes TRSDOS-II 
to check the drive hardware for a "door opened" 
condition. Set Push-Button and Thinline drives to 


DETECT. 
NODETECT (used for floppy drives only) sets the 
diskette swap to "no detection." This causes 


TRSDOS-II to ignore any "door opened" conditions 
received from the drive hardware. Set Latch 
drives to NODETECT. 
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WAIT (used for floppy drives only) sets TRSDOS-II to 
wait for the drive to gain proper motor speed, if 
a "Drive Not Ready" error occurs. TRSDOS-II tries 
again. If the error occurs again, the drive is 
considered not ready, and an error code is 
generated. Set Thinline drives to WAIT. 

NOWAIT (used for floppy drives only) sets TRSDOS-II 
to not wait if a "Drive Not Ready" error occurs. 
Immediately generates an error code. Set 
Push-Button and Latch drives to NOWAIT. 

OFFLINE (used for secondary drives only) sets a drive 
off-line. TRSDOS-II ignores that drive. 

ONLINE (used for secondary drives only) sets a drive 
on-line. ONLINE is the default. 


Gaining the Best Use of Floppy Disk Drives 


When TRSDOS-II starts up, it initializes your drives to the 
following settings: 


Seek Swap Wait/Nowait 
Drive Rate Detect Status 

1% ms DETECT WAIT 
1 - 3 15 ms NODETECT WAIT 


Any type of floppy drive can operate under these settings. 
However, to get the best use of your particular drive, try 
different settings. 


There are three types of drives that could be on your 
computer. Each type has its own specifications that 
determine how it can be set up. 


You can determine the type of drive you have by looking at 
the pictures on the next page. 
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Push-Button Latch Thinline 


The Three Types of Drives. 


We suggest you try the following settings for each of these 
drives. 


Seek Swap Wait/Nowait 
Drive Rate Detect Status 
Push-Button 19% ms DETECT NOWAIT 
Latch 15 ms* NODETECT* NOWAIT 
Thinline 3 ms DETECT WAIT* 
* These settings are required for these particular 


drives and are set this way at startup. 
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When using DRIVE with the seek rate, swap detect, and wait 
options, be sure to note the following: 


‘ When reset, TRSDOS-II always returns to the 
startup settings. Once you have tested the 
settings on your computer, you can use the AUTO 
command (or a DO file) to start the DRIVE utility 
automatically upon power-up or reset. 


‘ If you receive many I/O errors on disk 
reads/writes after changing the seek rate, you 
probably set the rate too fast for that particular 
drive. To solve this, either issue the DRIVE 
command again with the proper seek rate or reset 
the computer. 


‘ Latch drives cannot detect whether a drive door 
has been opened since the last disk access. 
Always set Latch drives to the NODETECT option. 


‘ Thinline drives have a built-in feature to reduce 
the wear on the floppy diskette. If a Thinline 
drive is not accessed for 28 seconds or more, 
the drive motor shuts off until the next drive 
access. At the next disk access, it takes about 
8/18 of a second for the motor to reach proper 
speed. 


‘ Always set Thinline drives to the WAIT 
option. If you run a Thinline drive with the 
NOWAIT option, a "Drive Not Ready" error occurs 
because the motor could not reach the proper speed 
before the access. 


Examples 
If your Drive @ is a Thinline, this command: 
DRIVE @ {RATE=%,DETECT,WAIT} <ENTER> 


lets you get the best use of Drive Q@. 
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If your Drive 1 is a Push-Button, this command: 
Drive 1 {RATE=2,DETECT,NOWAIT} <ENTER> 
lets you get the best use of Drive l. 
If your Drive 1 is a Latch, this command: 
DRIVE 1 {RATE=3,NODETECT,NOWAIT} <ENTER> 


lets you get the best use of Drive l. 


Turning Drives Off-Line 


The OFFLINE option turns a secondary disk drive off-line; 
ONLINE turns it back on-line. You can use both options with 
hard or floppy secondary disk drives: 


. Hard Disk Drives -- If you have more than one hard 
disk drive, you can move or copy files to your 
secondary drives and turn these drives off-line. 
Thus, you protect your files from access and/or 
change. 


‘ Floppy Drives -- When you turn a non-existing or 
unused secondary floppy drive off-line, TRSDOS-II 
accesses your disks faster. 


The default is ONLINE. When you turn a floppy disk drive 
back on-line after it is off-line, you must also use the I 
command to re-initialize the drive. 


Examples 
DRIVE 5 {OFFLINE} <ENTER> 
protects files on Drive 5 from access. 
DRIVE 3 {OFFLINE} <ENTER> 


tells TRSDOS-II not to access Drive 3; this speeds up access 
time. 
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DRIVE 2 {ONLINE} <ENTER> 
tells TRSDOS-II to try to access Drive 2. 


Tf you have a hard disk, you might find it helpful to create 
a command file (see the BUILD command for details) of these 
commands: 


DRIVE 6 {ONLINE} 
MOVE !:5 TO 6 {ABS} 
DRIVE 6 {OFFLINE} 


This causes TRSDOS-II to turn Drive 6 on-line, move all the 
files on Drive 5 to Drive 6, and then turn Drive 6 back 
off-line. 


Using AUTO to Set Drives 
You also can build a special command file that automatically 
sets your floppy disk drives for maximum efficiency and 
turns any non-existent drive off-line as you start up. 
For example, if your computer has two Thinline floppy drives 
and two hard disk drives, you can use the following as your 
automatic command file. (See the AUTO, BUILD, and DO 
commands for more information. ) 
First get into the BUILD command mode by typing: 

BUILD DRIVESET <ENTER> 


Now you can enter program lines such as: 


DRIVE 9 {RATE=9%,DETECT,WAIT} <ENTER> 
DRIVE 1 {RATE=%,DETECT,WAIT} <ENTER> 
DRIVE 2 {OFFLINE} <ENTER> 
DRIVE 3 {OFFLINE} <ENTER> 
DRIVE 6 {OFFLINE} <ENTER> 
DRIVE 7 {OFFLINE} <ENTER> 

> 


<ENTER 
The last line saves the program lines. 
To set this command file as the auto command, type: 


AUTO DO DRIVESET <ENTER> 
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Now, whenever you start up your computer, the DRIVESET 
command file executes automatically and sets all your drives 
to their maximum efficiency. 


When you set a command file such as DRIVESET as the auto 
command, TRSDOS-II overwrites any existing auto. To set a 
command file and keep the existing auto, use an example such 
as the following. 


The SCRIPSIT system diskette has the auto command STARTUP 

set. When you enter the date and time, this auto command 

initializes the SCRIPSIT system diskette and goes directly 
to the SCRIPSIT menu. 


If you want to set an auto file that uses this auto startup 
and sets the drives to their maximum efficiency, you can 
use the following command file. 


If you have a computer with four Thinline floppy disk drives 
and one hard disk drive, get into the BUILD command mode and 
enter lines -such as: 


DRIVE @ {RATE=%,DETECT,WAIT} <ENTER> 
DRIVE 1 {RATE=%,DETECT,WAIT} <ENTER> 
DRIVE 2 {RATE=%,DETECT,WAIT} <ENTER> 
DRIVE 3 {RATE=%,DETECT,WAIT} <ENTER> 
DRIVE 5 {OFFLINE} <ENTER> 
DRIVE 6 {OFFLINE} <ENTER> 
DRIVE 7 {OFFLINE} <ENTER> 


STARTUP <ENTER> 
<ENTER> 
Now when you enter the command: 
AUTO DO DRIVESET <ENTER> 
TRSDOS-II automatically sets the drives to their maximum 


efficiency, turns non-existing drives off-line, and then 
starts up SCRIPSIT. 
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DUAL Library Command 


DUAL {switch} 


Sends the video display output to the printer and vice 
versa. 


You must use one of the switch options. They are: 
ON Turns dual routing on 
OFF Turns dual routing off 


Because there are intrinsic differences between the output 
devices and the output software, the printer and display 
outputs may differ. 


When dual routing is on, the video output process slows. 


Be sure your printer is on-line and powered up while dual is 
on. If it is not, the video display appears to output 
characters at the rate of 1 every 3 seconds (3@ seconds, if 
you have run the LPII patch file). To solve this, turn DUAL 
off or ready your printer. 
Examples 

DUAL ON <ENTER> 


turns dual routing on, so all output is sent to the line 
printer and video display at the same time. 


DUAL OFF <ENTER> 


turns dual routing off. 
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DUMP Utility Program 


DUMP filespec {options} 


Copies the filespec, a machine-language program, from memory to 
disk. You can then load or execute the program at any time. 


hhhh is a 4-digit hexadecimal number without the X* ' 
notation. 


You can use some or all of the following options: 

START=hhhh sets the program's starting address. 

You must include this option. 

END=hhhh sets the program's ending address. You 
must include this option. 

TRA=hhhh sets the address at which your program 
begins executing after you load it. If you omit 
this option, DUMP uses the address set by RELO. 
The transfer address must be less than the ending 
address. 

RELO=hhhh sets the address at which your program 
begins loading back into memory. If you omit this 
option, TRSDOS-II uses START. 

RORT=R (Return) loads filespec, but does not 
execute it. 

RORT=T (Transfer) loads and executes filespec from 
TRSDOS-II Ready. If you omit the RORT= options, 
TRSDOS-II uses RORT=T. 


Examples 

DUMP TEST/FIL START=64F9, END=6AF9, TRA=67F2,RORT=R <ENTER> 
creates filespec TEST/FIL, which contains the program in 
memory location X'64F%' to X'6AF%'. When loaded, it 

occupies the same memory location. Since RORT=R, you cannot 
execute the program from TRSDOS-II Ready mode. 

DUMP INTCOM/DMA START=609% END=67FF TRA=3198 RELO=389@ <ENTER> 


creates filespec INTCOM/DMA, which contains the program in 
memory range X'699M' to X'67FF'. When loaded, the program 
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resides from X'39@%' to X'37FF' and execution starts at 
X'3198'. You can execute the program from the TRSDOS-II 
Ready mode by typing: 


INTCOM/DMA <ENTER> 
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ECHO Library Command 
ECHO 


Lets you type information to the display, without TRSDOS-II 
interpreting it as a command. Press <BREAK> to stop ECHO 
and return to TRSDOS-II Ready. 


Example 


DUAL ON <ENTER> 
ECHO <ENTER> 


Now, what you type is output to the printer, as well as to 
the display. (Most printers do not print the line until 


they receive a carriage return or the input buffer is 
FLLLeG), 
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ERROR Library Command 
ERROR number 


Displays a message that describes error number. When 
TRSDOS-II gives you a reverse (black-on-green/white) 
message, such as: 

* * ERROR 47 * * 
You can find out what ERROR 47 is by typing: 

ERROR 47 <ENTER> 


For a complete list of error codes, messages, and 
explanations, see Appendix B of this manual. 


Example 
ERROR 3 <ENTER> 
returns the error message: 


PARAMETER ERROR ON CALL 
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FC Library Command 


FC 


Edits and repeats the last command entered. 


When you specify FC ("fix command"), TRSDOS-II displays the 
last command entered and lets you edit that command. Then, 
it executes the edited command. 


After "fixing" the command, you can execute it only when the 
cursor is positioned as far left as possible on the line. 
Press <ENTER> to move the cursor to this position. Press 
<ENTER> again to execute the "fixed" command. 


Use the following subcommands to edit command lines: 


Key Function 


<F1l> Inserts blank spaces. (Note: Blank spaces 
are the only insertions that FC allows. die 
you need to insert characters, insert 
spaces and then type over the spaces with the 
desired characters.) 


<F2> Deletes a character. 

<CTRL> <E> Moves the cursor to the end of the line. 

<ESC> Starts over. TRSDOS-II disregards all 
previous changes. 

<BREAK> Aborts and returns to TRSDOS-II Ready. 

<ENTER> Moves the cursor to the left-most position. 


Tf cursor is already there, TRSDOS-II 
executes the command. 


<left arrow> Moves the cursor to the left. Does not wrap 
around. 
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<right arrow> Moves the cursor to the right. When the 
cursor reaches the last position on the line, 
it returns to the left-most position. 

<TAB> Tabs (skips over) to the next tab stop, 
without eraSing characters. Tabs are set at 
8-space intervals (8, 16, 24, and so on). 

<CTRL> <T> Back-tabs without erasing characters. 


<CTRL> <W> Deletes to the end of the line, starting at 
the current cursor position. 


Example 
Suppose you have just executed the following command: 
COPY PAYROLL/DAT:1 :4 <ENTER>, type: 


To re-display the command for editing, type: 


FC <ENTER> 
Move the cursor so it is on top of the number 4 -- by 
pressing <TAB> or <right arrow> -- and type the number 3. 


Press <ENTER> to return the cursor to the beginning of the 
line. The new command is: 


COPY PAYROLL/DAT:1 :3 


Press <ENTER> again to execute the command. 
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FCOPY Utility Program 
FCOPY source TO destination {options} 


Copies files from floppy diskette TRSDOS 1.2, Les: Zee 
2.fa, or 2.8b to a disk formatted by TRSDOS-II (and vice 
versa except to TRSDOS 1.2 or 1.2a). 


If you are going to use TRSDOS files under TRSDOS-II, you 
must FCOPY the files to disks formatted by TRSDOS-I1I. 

This is because TRSDOS formats 26 sectors per diskette track 
and TRSDOS-II formats 32 sectors per diskette track and 34 
sectors per hard disk track. If you try to use a TRSDOS 
diskette while operating under TRSDOS-II, you get the error 
"Tllegal I/O Attempt." 


You can also use FCOPY to get a directory listing while 
operating under TRSDOS-II. The directory can be for files 
formatted by either TRSDOS or TRSDOS-II. The syntax for 
this special use of FCOPY is given later in this entry. 


The source is one of the following: 
filespec that must include a drive number 
wildcard:drive 
drive 


If you specify the source as a drive number and 
omit ALL, TRSDOS-II prompts you to enter a 
wildcard mask. 


The destination is one of the following: 
filespec, only if the source is also a 
filespec. The filespec must include a drive 
number. 
drive 


drive is a drive number from 9-7. 


You cannot use FCOPY with FLOPPY {OFF}. (See FLOPPY 
command, ) 
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The options are: 


ABS overwrites any existing data without prompting. 
If you omit this option, TRSDOS-II prompts you 
before overwriting. 

PROMPT tells TRSDOS-II to prompt you before it copies 
a file. Press <Y>, <N>, <Q>, or <S> (for "yes," 
‘no; "- "OU Le, OF “Stop: prompting”). 

ALL copies all user files. 

SYS copies language and application programs. 

If you use SYS, the destination must be the 
primary drive. If you omit this option, only user 
files are copied. 


The syntax for displaying a directory listing is: 
FCOPY drive {DIR,SYS,PRT} 
The braces are required with this form of FCOPY. 
When you use the FCOPY command with DIR and SYS, TRSDOS-II 
returns the directory according to the way the diskette in 


the specified drive is formatted. For example, if you 
enter the commmand: 


FCOPY 1 {DIR,SYS} <ENTER> 


and the diskette in Drive 1 is formatted by TRSDOS 2.@a, the 
computer returns a directory of both system and user files. 


On the other hand, if you use the same command on a disk 
formatted by TRSDOS-II, it returns a directory of system 
files only. 


Examples 
FCOPY NEWFILE/TXT TO :3 <ENTER> 


copies NEWFILE/TXT, which is on a TRSDOS-formatted diskette, 
to the Drive 3 diskette, formatted by TRSDOS-II. 


FCOPY 1 TO @ {ALL} <ENTER> 


copies all user files from the TRSDOS-formatted diskette in 
Drive 1 to the Drive @ diskette, formatted by TRSDOS-II. 
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FCOPY !:4 TO 1 <ENTER> 


copies all user files, with and without extensions, from the 
Drive 4 to Drive 1. (See "Super Wildcard" in the 
‘Tritroduction.«"™) 


FCOPY TRN/TXT:1 TO TRNTXT/OLD:4 <ENTER> 


copies the file TRN/TXT from the diskette in Drive 1 to 
Drive 4. It names the new file TRNTXT/OLD. 


FCOPY 2 {DIR} <ENTER> 


lists the directory of user files for the TRSDOS diskette in 
Drive 2. 
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FILES Utility Program 


FILES source {options} 


Lists alphabetically the filenames that are stored on the 
Specified source. 


The source can be a filespec, wildcard, or drive number 
(9-7). If you omit the drive number, TRSDOS-II goes to the 
primary drive. 


The options are: 
SYS lists all system files. SYS is optional; if 


you omit it, TRSODS-II lists only the user files. 
PRT prints the files. PRT is optional; if you omit 
it, TRSDOS-II lists the files on the screen. 


Unlike the DIR command, FILES lists only filenames. It 
lists them in five columns (from left to right) across the 
screen. 


FILES allows full wildcarding. For details, see "Wildcards" 
in the “Introduction.. ™ 


Examples 
FILES */BAS:4 {PRT} <ENTER> 


lists to the printer all user files in Drive 4 that have the 
extension /BAS. 


FILES @ {SYS} <ENTER> 


lists on the display all Drive @ system files. The system 
directory is in Drive @ on a floppy drive system. 
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FLOPPY Library Command 
FLOPPY {switch} 


Ignores all references to floppy drive numbers within 
filespecs. This is useful when a program or library command 


includes a reference to a filespec in which a drive is 
specified. 


The switch options are: 
ON sets FLOPPY on. TRSDOS-II goes to the drive(s) 
specified in the filespec. 
OFF sets FLOPPY off. TRSDOS-II ignores the drive 
number(s) in the filespecs. 


If you omit both options, TRSDOS-II displays the current 
status of FLOPPY. 


TRSDOS-II powers up using FLOPPY {ON}. 


Only those commands that require filespecs are affected by 
FLOPPY. These are: 


ATTRIB DO MOVE 
APPEND DUMP OPEN 
BUILD KILL PATCH 
COPX LIST RENAME 
CREATE LOAD 


When any of these commands is used with FLOPPY (ORE }, 
TRSDOS-II ignores the drive numbers. The drive search 
begins with the primary drive. 
Examples 
FLOPPY {OFF} <ENTER> 
TRSDOS-II begins the search with the primary drive. 
FLOPPY {ON} <ENTER> 
uses the drive numbers included in a filespec. 


FLOPPY <ENTER> 


displays the status of FLOPPY. 
® 
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FORMAT Utility Program 


FORMAT drive {options} 


Prepares a blank disk for use by defining the tracks and 
sectors and writing system information onto it. (For more 
information, see "Diskette Organization" in the "Technical 
Information" section. ) 


With a hard disk, FORMAT initializes the system, as well as 
formats it. Formatting Drive 4 (the primary hard disk 
drive) transfers TRSDOS-II to that drive. Then, whenever 
the computer is turned on or reset, it automatically loads 
TRSDOS-II from Drive 4. 


You can format either a blank or already formatted disk. If 
the disk already is formatted, you lose all information when 
you reformat it. 


You can format a single- or double-sided disk, without 
spedifying the number of sides. TRSDOS-II automatically 
formats the correct type. 


drive specifies the drive in which the blank disk is to be 
formatted. It can be one of the following numbers: 1, 2, 
3, 4, 5, 6, or 7. You cannot format your primary drive (the 
drive that contains the operating system). Floppy drive 
users cannot format Drive @. Hard disk users cannot format 
Drive 4, except to initialize. 


If you omit the drive, TRSDOS-II prompts you for it. 


The options are: 


ABS overwrites any existing data without prompting. 
If you omit this option, TRSDOS-II prompts you 
before overwriting. 

ID=disk-name assigns a name to the disk being 
formatted. If you omit this option, TRSDOS 
is used. 

PW=password assigns the master password to the 
disk. The master password allows access to all 
user files (via the PROT command). It also allows 
full BACKUP privileges. If you omit this option, 
PASSWORD is used. 
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DIR=number places the primary directory on Cylinder 
number. If you omit this option, TRSDOS-II uses 
Cylinder 44 for floppy diskettes or Cylinder 139 
for hard disks. You can put the primary directory 
on any cylinder from 1-71 for floppy diskettes or 
from l-maximum cylinder number minus 3 for hard 
disks. 

ALT=number places the alternate directory on 
Cylinder number. If ALT=9%, no alternate 
directory is created. If you omit the ALT= 
option, TRSDOS-II uses the formula directory + 3 
to compute the placement of the alternate 
directory. For floppy diskettes, 3 represents 
three tracks; for hard disks, it represents three 
cylinders. You can put the alternate directory 
on any cylinder from 1-71 for floppy diskettes or 
from 1l-maximum cylinder number minus 3 for hard 
disks. 

SIZ=number puts the specified number of. filenames 
in the initial directory. For hard disks and 
floppy diskettes, the number can be from 1-2229@. 
Tf you omit this option, the number defaults to 
188 (single- or double-sided floppy) or 336 (hard 
disks). 

FULL/NONE is the verification level. FULL reads 
each sector and compares it to the value written 
during initialization. NONE prevents 
verification. FULL is the default. 

ILV=number sets the interleave factor (ratio of 
number:1), which determines the order in which 
TRSDOS-II is to access disk sectors. Between disk 
accesses, TRSDOS-II must do a certain amount of 
processing. (The amount depends upon your 
application.) The proper ILV factor can reduce 
file work time by minimizing disk rotation 
between accesses. If you omit the option, the 
number defaults to 19. 

HDS=number (for hard disk systems only) specifies 
the number of heads on a drive. You can obtain 
the number from your Hard Disk Owner's 
Manual. If the drive number is from 4-7, HDS= 
is required. If you omit the option, TRSDOS-II 
prompts you for the number. 
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CYL=number (for hard disk systems only) specifies 
the number of cylinders on a drive. You can 
obtain the number from your Hard Disk Owner's 
Manual. If the drive number is from 4-7, CYL= 
is required. If you omit the option, TRSDOS-II 
prompts you for the number. 

PRE=number (for hard disk systems only) sets the 
write precompensation start cylinder for a hard 
disk, If you: omit the option; 16 defaults to 128; 
If you change the PRE= default, the DIR= default 
changes to PRE + 2 and the ALT= default changes 
to DIR + 4. 


Note: If you are not familiar with interleave factors and 
write precompensation, we recommend that you do not use the 
ILV= and PRE= options. The default values for these options 
are suitable for most applications. 


Examples 
FORMAT 1 {ID=ACCOUNTS ,PW=IRS} <ENTER> 


formats the diskette in Drive 1, names it ACCOUNTS, and 
gives it the password IRS. 


FORMAT <ENTER> 


prompts you for the drive to use and then formats the disk 
in that drive. Since no options are used, the disk is 
named TRSDOS, the password is PASSWORD, and all the other 
options are defaults. 


FORMAT 2 {DIR=91,ALT=9%4,SIZ=360} <ENTER> 
formats the diskette in Drive 2, puts the primary directory 
on Cylinder 1 and the alternate directory on Cylinder 4, 
and sets the number of directory records to 369. (The 
leading zeroes in the cylinder specifications are optional.) 


FORMAT 4 {HDS=6,CYL=239%} <ENTER> 


formats Drive 4 for 6 read/write heads and 23@ cylinders and 
automatically transfers TRSDOS-II to Drive 4. 
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When to Format 
To prepare a new disk 


Before you can use a new disk, you must format it (unless it 
is a floppy diskette and you use BACKUP). After formatting, 
record the disk name, date of creation, and password. Store 
this information in a safe place. It helps you estimate how 
long a diskette has been in use. And, if you forget the 
master password, it ensures continued access. 


To erase all items of data from a disk 


To "start over" with a disk, you can reformat it. This 
erases all old information and locks out all flawed sectors 
which have developed. It puts the system information back 
on the disk and leaves the "good" sectors available for 
information storage. Use the FULL verification option with 
this application. 


To initialize a hard disk system 
Before you can use your hard disk system, you must format 
the hard disks. Formatting Drive 4 transfers TRSDOS-II to 


that drive. You must use HDS= and CYL= when formatting hard 
disks. 
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FORMS Library Command 


FORMS {format options} 
FORMS {switch options} 


Sets up printer parameters. 


The format options are: 


P=number sets the number of lines per page. 
The number can be from @-255. If omitted, P=66. 
L=number sets the maximum number of lines to 
print on a page before issuing an automatic top of 
form. The number can be from 9-255. If 
omitted, L=6@. The number of lines must be less 
than or equal to the page length. If either is @, 
both must be @. If L=@, TRSDOS-II issues no 
automatic top of form. 
W=number sets the maximum number of characters to 
print on a line before issuing an automatic 
carriage return. The number can be from §-255. 
If omitted, W=132. If W=%@, TRSDOS-II issues no 
automatic carriage returns. | 
C=byte sets the output to the specified 1-byte WwW 
hexadecimal control code and sends it to the 
printer on completion of the FORMS command. 


The default parameters are P=66, L=69@, W=132, and c=. If 
you want to use the default parameters, you don't need to 
issue the FORMS command. 


To determine the parameters to set for the format options, 
use the following formulas: 


P (lines per page) = 
lines per inch * inches per form length 
L (printed lines per page) = 
lines per page - lines per top and bottom margins 
W (characters per line) = 
characters per form width - characters per side margins 
If W is greater than the form width, TRSDOS-II 
automatically breaks the line at the maximum 
length and continues printing on the next line. 
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C (control codes) are required for some printers (for 
example, to set up for the double-space character). 
TRSDOS-II sends the specified code to the printer or 
print file during execution of the FORMS command. 


The switch options are: 


A outputs a line feed after a carriage return (auto 
line-feed mode), even if the transparent mode is 
in effect. A updates the line count by carriage 
returns, not by line feeds. 

ignores all printer output ("dummy" mode). 

returns to the normal (non-transparent, non-dummy ) 
mode. This is the default mode. 

cancels the auto line-feed mode. 

returns to the parallel printer driver. 

sends the top-of-form character, X'§C', to 
the printer. 

Switches to the Serial Channel B printer driver. 
(You must do SETCOM before data is sent to the. 
printer.) 

X sends all items of data to the printer or printer 

file without any translation (transparent mode). 


nM FHWO 20 


See the PRCTRL SVC in the "Technical Information" section 
for information on the transparent and dummy modes. 


Examples 
FORMS <ENTER> 

resets all FORMS parameters to the default values. 
FORMS P=56, L=51, W=92 <ENTER> 


sets the page length to 56, the printed lines per page to 
51, and the characters per line to 92. 


FORMS D <ENTER> 


invokes the dummy mode. TRSDOS- II ignores all printer 
commands. 


FORMS S <ENTER> 


sets up the serial printer driver. 
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FREE Library Command 


FREE drive {PRT} 


Lists the number of free sectors on a disk, the number of 
free sectors that are grouped (in areas called extents), and 
the number of extents. 


The drive is optional. If omitted, it defaults to the 
primary drive. 


PRT, also, is optional. If you use PRT, TRSDOS-II sends the 
list to the printer. If not, it displays the list on the 
video. If you omit the drive, you must enclose PRT in 
braces. 


FREE lists the extents that are available. The format is: 


nnnn nnnn nnnn nnnn 
nnnnn Free Sectors in n Extents 


nnnn is the number of sectors per extent. nnnnn is the 
total number of sectors on the disk. n is the number of 
extents on the disk. Here is a sample FREE list: 


FREE LIST for Drive:4 Disk Name: TRSDOS 
6 33 16587 34 L6592 
33252 Free Sectors in 5 Extents 

Examples 


FREE <ENTER> 


displays the amount of free space on the disk in the primary 
drive. 
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FREE {PRT} <ENTER> 
lists to the printer the amount of free space on the disk in 
the primary drive. Because no drive is specified in this 
example, you must use the braces, { }. 


FREE 2 PRT <ENTER> 


lists to the printer the amount of free space on the disk in 
Drive 2. 
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HELP Utility Program 
HELP command 


Displays the syntax of a TRSDOS-II command. 
The command is optional. If you omit the command or 
type an unrecognized command, TRSDOS-II displays the 
TRSDOS-II commands and general subjects for which HELP is 
available. 
The HELP command cannot be used from TERMINAL or BASIC. 
Example 

HELP MOVE <ENTER> 
displays the syntax for the MOVE command. 

HELP SYNTAX <ENTER> 


returns an explanation of the format of the HELP messages. 
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HOST Library Command 


HOST {switch} 


Lets your computer act as host to a remote terminal or a 
computer acting as a terminal. 


The switch options are: 
ON turns HOST on 
OFF turns HOST off 


The switch is optional. If you omit it, TRSDOS-II 
displays the switch on/off status. 


As the host, your computer communicates via Serial Channel 
A. It accepts keyboard input from the RS-232C interface and 
transmits all display output to the same interface. 


While HOST is on, the keyboard and the remote terminal both 
can provide keyboard input. Output is duplicated to the 
video display and Channel A. Remote characters have a 

Mm higher priority than local characters. 


To turn the HOST program on, follow this procedure: 


1% Initialize Serial Channel A with the SETCOM 
command. Use the appropriate parameters for your 
computer. (See the SETCOM command.) Do not turn 
off Channel A while HOST is active. 


2% Turh: the- AOSt on. by typing: 
HOST ON <ENTER> 


2% As TRSDOS-II starts HOST, it asks you if you want 
to disable the remote <BREAK> key. Answer 
accordingly. 


Examples 


If your computer is connected, via a modem, to another 
computer running the TERMINAL program, use this command: 
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HOST ON <ENTER> 
to instruct the computer to accept "keyboard" input from the 
remote terminal and to echo all display output to the remote 
terminal. 


To stop the HOST operation, type: 


HOST OFF <ENTER> 
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I Library Command 


I :drive 


Reads the diskette IDs from the specified floppy drive. If 
you omit the drive number, TRSDOS-II reads the IDs from 
all floppy drives. 


Whenever you swap diskettes, you must execute this command 
immediately after you swap diskettes. 


Use the I command after: 


: Using FORMAT 

: Inserting a different diskette into Drive @, 1, 2, 
or Ss 

* Using FCOPY, BACKUP, SAVE, or RESTORE. 


If the diskette you insert after the swap is formatted by 
a TRSDOS (instead of TRSDOS-II), TRSDOS-II displays Error 39 
| (Illegal I/O Attempt). 


Note: When you swap From a single-sided diskette 
to a double-sided diskette (or vice versa) in 
Drive 9, you must press the RESET switch after 
Swapping. 
Example 
I <ENTER> 
reads the diskette IDs from all floppy drives in the system. 


iL $3 <ENTER> 


reads the diskette ID from Drive 3. 
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KILL Library Command 


KILL filespec 


Deletes filespec from the directory and frees the space 
allocated to it. The filespec can be a wildcard with 
drive number. 


Before i deletes the file, TRSDOS-II displays the complete 
Sere ag Ee ee te eee Ses nt tno! or 
"Su1t." 
Example 

KILL DATAFILE/OLD <ENTER> 


deletes DATAFILE/OLD from the directory and frees all space 
allocated to it. 


KILL */BAS:4 <ENTER> 
deletes all files with the extension /BAS. MTRSDOS-II 


prompts you before deleting each file. You can end the 
process by pressing <Q> to quit. 
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LIB Library Command 
LIB 


Displays a list of all library commands. 

The LIB command list includes only those commands located 
below X'28@@'. Therefore, you can execute library commands 
from BASIC, TERMINAL, and so on. The library commands 
CLEAR, DEBUG, and DO return to TRSDOS-II Ready. 

Example 


LIB <ENTER> 


returns a list of the TRSDOS-II library commands. 
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LIST Utility Program 


LIST filespec {options} 


Lists the contents of filespec. 


This list shows the hexadecimal contents and the ASCII 
characters corresponding to each value. For values outside 
the range of X'29' to X'7F', TRSDOS-II displays a period 
Cyd s 


The options are: 
PRT lists the contents of filespec to the printer. 


If you omit PRT, TRSDOS-II sends the list to the 
video display. 

SLOW pauses between records. If you omit SLOW, 
TRSDOS-II does not pause. 

=number sets the starting record to the number, 

which can be from 1-65535. If you omit the R= 
option, TRSDOS-II uses 1. (See the "Technical 
Information" section for details.) 

A lists only the ASCII characters. 


Examples 
LIST DATA/BAS <ENTER> 

lists the contents of DATA/BAS. 
LIST TEXTFILE/1 SLOW <ENTER> 

lists the contents of TEXTFILE/1, pausing between records. 
LIST TEXTFILE/1 R=199,A <ENTER> 


lists TEXTFILE/1 starting with the 19@th record. TRSDOS-II 
displays only ASCII characters. 


LIST PROGRAM/CMD PRT <ENTER> 


lists PROGRAM/CMD to the printer. 
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LOAD Library Command 


LOAD filespec 


Loads a machine-language program named filespec and then 
returns to the TRSDOS-II mode. 


Example 
LOAD MARKET/OBJ <ENTER> 


loads the machine-language program file named MARKET/OBJ 
into memory. 
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MEMTEST 


Tests the random access memory (RAM) in your computer. You 
may select either a full memory test (X'@PPP' to end) or a 
user memory test (X'3@MM' to the top of user memory). 


Note: See the STATUS command to locate the top of 
user memory. 


To execute the test, type the following at TRSDOS-II Ready: 
MEMTEST <ENTER> 


After running the full memory test, you must reset the 
system. 


After running the user memory test, control returns to 
TRSDOS-II Ready. During the operation, all user memory is 
cleared. No high-memory routines should be active while 
MEMTEST is running. Use the STATUS command to find out if 
any are active. 
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MOVE Utility Program 
MOVE source TO destination {options} 


Copies one or more user files to the destination disk. 


The source is one of the following: 
filespec 
Wildcard:drive You can use either a wildcard (*) 
or super wildcard (!). 
drive 


If you specify drive and omit the ALL option, 
TRSDOS-II prompts you to enter a filespec or 
wildcard mask. 


The destination is the drive number of the disk to which 
you want your files moved. Your moved files retain the name 
of the source filespec. 


drive is a drive number from 9-7. 


The options are: 
ABS overwrites, without prompting, any existing 
files on the destination disk that have the same 
name as the source. 
PROMPT displays each file before moving it and 
gives you a set of options for that file. The 


PROMPT options are: Y/N/S/Q (for "Yes -- Copy," 
"No -- Don't copy," "Stop prompts and proceed with 
all copies," "Quit this command -- Make no more 


copies"). If you omit PROMPT, TRSDOS-II moves all 
files that match the file specifications. 
ALL moves all user files. 


Note: You cannot move password-protected files. 


MOVE is useful when you want to copy all of your TRSDOS-II 
files from floppy diskette to hard disk, or vice versa. 
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For example, type: 
MOVE @ TO 4 {ALL} <ENTER> 


to move all your user files from the diskette in Drive @ to 
the hard disk. 


Examples 
MOVE DAT/FLE:1 TO 3 <ENTER> 


moves the file DAT/FLE from the diskette in Drive 1 to the 
diskette in Drive 3, keeping the filename DAT/FLE. 


MOVE */PAY:4 TO 2 <ENTER> 


copies all user files with the extension /PAY from Drive 4 
to the diskette in Drive 2. 


MOVE !:4 TO 3 <ENTER> 


moves all user files, with and without extensions, from 
Drive 4 to the diskette in Drive 3. 
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PATCH Utility Program 


PATCH filespec {options} 


Lets you make minor corrections in any disk file, provided 
that: 


; You know the existing contents and location of the 
data you want to change 


‘ You want to replace one string of code or data 
with another string of the same length 


‘ The file is a fixed-length record file (FLR file) 


The filespec is the file you want to change. If it is a 
system file, you need not include a password. If it is a 
protected user file, however, you must include the password. 


The options are: 
A=hhhh sets the starting address of the data 


to be changed. This is where the data resides in 
memory when the program is loaded. hhhh is a 
4-digit hexadecimal value without the X' ' 
notation. 

F=findstring indicates the string that is now in 
the patch area. 

=changestring indicates the data that is to 

replace the findstring. The changestring must 


contain the same number of bytes as the 


findstring. 
R=record tells which record contains the data to be 


Changed. It is a decimal number from 1-65536. 


B=starting byte specifies the position of the first 
byte to be changed. It is a decimal number from 


LAZO 


Use either the A= option alone or the R= and B= options 
together. 


You can use PATCH to make minor changes in your own 
machine-language programs. You can use PATCH to make minor 
replacement changes in data files, also. 
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PATCH lets you implement any changes to TRSDOS-II that may 
be supplied by Radio Shack. This way, you do not have to 
wait for a new release of TRSDOS-II. 


Note: If you press <BREAK> during a PATCH operation, 
before any changes have been made in the file, PATCH closes 
the file and returns to TRSDOS-II. The file is unchanged. 
Once the PATCH process begins, however, <BREAK> has no 
effect. 


Using PATCH on a TRSDOS-II System File 


When Radio Shack releases a modification to TRSDOS-II, you 
receive a printout of the exact PATCH commands that you must 
enter to make the change. 


To make such a change, follow these steps: 


is Make a backup copy of the TRSDOS-II diskette to be 
patched. 


24 Insert the TRSDOS-II diskette to be changed into 
Drive @. (Make sure the diskette is not write- 
protected. ) 


a5 At TRSDOS-II Ready, type in the PATCH command 
specified in the printout. 


4. After the patch is complete, reset the computer to 
see that the diskette is operating as a TRSDOS-II 
system diskette. 


Using PATCH on a Z-8@ Program File 


In this context, "program files" refers strictly to those 
Files stored with the P attribute. Use the DIR command to 
learn the attribute. (See instructions for changing data 
Files.) 


If you want to change four bytes in a machine-language 
program file, you must first determine where the 4-byte 
sequence resides in RAM when the program is loaded. Next, 
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make sure your replacement string is the same length as the 
original string. For example, you might write down the 
information as follows: 


File to change: VDREAD 

Start address: X'5289' 

Sequence of the code to change: K'CD2C75n5"* 
Replacement code: X'PPPPBPCI' 


Then, you could use the following command: 


PATCH VDREAD A=528@,F=CD2C25E5,C=SPPAPGCI 


Using PATCH on Data Files (Including BASIC Programs ) 


If you have a file stored with the D attribute (data file), 
you must specify the patch area in terms of the logical 
record that contains the data and the starting byte of the 
data. (The LIST command gives this information. ) 


For example, if you want to change a 12-byte sequence ina 
file called NAMEFILE, use the LIST command to find the 
location of the sequence. If it is in Record 128, starting 
at Byte 14, write down the information this way: 


File to change: NAMEFILE 

Record number: 128 

Starting byte: 14 

Sequence of text to change: "JOHN'S DINER" 
Replacement text: "JACK'S PLACE" 


Then, use the following command to patch a data file: 
PATCH NAMEFILE R=128,B=14,F="JOHN'S DINER",C="JACK 'S PLACE" 


For data files, notice that either string can include 
single quotation marks, as long as the string is enclosed 
within double quotation marks (or vice versa). 


Error Conditions 
If a TRSDOS-II error occurs during the patch operation, you 


receive the appropriate error message, and the patch ends 
without changing the file. 
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PATCH can produce these messages, also: 


PATCH STRING TOO LONG -- ABORT This occurs when you 
patch a data file and the findstring spans two 
records. You must perform the patch in two 
steps, one for each record that contains a part of 


the findstring. 


FILE CONTAINS VARIABLE-LENGTH RECORDS -- ABORT You 
can patch FLR files only. 


STRING NOT FOUND The findstring was not found at 
the patch location you specified. Before patching 
a file, you must know the exact patch location and 
the contents at the location. 


ADDRESS OUT OF PROGRAM-LOAD RANGE -- ABORT This 
occurs when you attempt to patch a program file 
and some or all of the patch string (either the 


findstring or the changestring) is outside the 
RAM area where the program resides when it is 


loaded. Check the A= option. Also, be 


sure the findstring and changestring are not 
longer than you intend them to be. 
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PAUSE Library Command 


PAUSE prompt message 


Displays PAUSE and the prompt message and prompts you to 
press any key to continue. 


The prompt message is optional. If you omit at, TRSDOs=-11 
displays PAUSE. 


This command is useful in a DO file. (See the DO command 
for more information. ) 


Example 
Type: 

PAUSE Insert Diskette #21 
to display: 


PAUSE Insert Diskette #21 
Press any Key to Continue 


Press <ENTER> to continue. 
Type: 

PAUSE <ENTER> 
to display: 


PAUSE 
Press any Key to Continue 


Press <ENTER> to continue. 
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PRINT Utility Program 


PRINT filespec {A,V} 


Prints out the contents of the filespec, omitting the 
record numbers and hexadecimal codes (LIST gives those). 


The filespec must be a text file. 


The options are: 
A treats the first byte in each record as a FORMS 


control character. The meaning of the character 

in the first byte is: 

"1" does a form feed before printing (top of 
TOrin) 

"b" does a carriage return before printing 
(single-space). 

"9" does two carriage returns before printing 
(double-space). 

"4+" does a carriage return without a line feed, 
if the printer has the ability. The 
characters that follow the code are printed 
over the current line. | 

V outputs the filespec to the video display, as well 
as to the printer. 


Use the A option when the filespec contains the control 
codes Listed ‘Gal "p™. 0 ae LP a 


Example 
PRINT PROGRAM/TXT V <ENTER> 


outputs PROGRAM/TXT to the video display, as well as to the 
HEINEY, 
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PROT Library Command 
PROT drive {options} 


Changes the password protection of the disk in the specified 
drive by using the master password. 


The options are: 
OLD=password specifies the disk's current master 


password. This option must be specified when 
uSing any option below. 

NEW=password specifies the disk's new password. 

LOCK asSigns all user files the new master password. 
TRSDOS-II sets both the update and access words to 
this value. (See the ATTRIB command for 
information on access and update passwords. ) 

UNLOCK removes the passwords from all user files. 


You first assign a disk's master password during format or 
backup. Your TRSDOS-II system disk has the master password 
PASSWORD. 
Examples 


PROT 1 OLD=PASSWORD, NEW=H20 <ENTER> 


changes the master password of the diskette in Drive 1 from 
PASSWORD to H20. 


PROT @ OLD=H20, UNLOCK <ENTER> 


removes passwords from every user file on the diskette in 
Drive @. 


PROT @ OLD=H20, NEW=ELEPHANT, LOCK <ENTER> 


changes the master password from H20 to ELEPHANT and assigns 
the new password to every user file. 
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PURGE Library Command 


PURGE {drive} {options} 


Deletes files from the disk in the specified drive. 


The drive is optional. If you omit it, TRSDOS-I1l uses the 
primary drive. 


The options are: 
SYS System files (program and data) 


PROG User machine-language program files 
DATA User data files 
ALL User program and user data files 


If you omit the options, TRSDOS-II lets you purge data files 
only. 


Once you enter the PURGE command, TRSDOS-II prompts you for 
the disk's password. Type in up to eight characters and 
press <ENTER>. (All disks distributed by Radio Shack use 
PASSWORD as the password. ) 
The system then displays the filenames, one at a time. It 
prompts you to kill the file, keep it, or quit the 
operation. 
Examples 

PURGE 1 <ENTER> 
deletes data files from Drive l. 


PURGE 2 {PROG} <ENTER> 


deletes user machine-language program files from the 
diskette in Drive 2. 
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RECEIVE Utility Program 


RECEIVE {CH=channel, offset} 


Lets you receive object code from another computer via 
RS-232C. The data must be sent in Intel Hex Format as 
described below in "Required Data Format." 


The channel, which is required, can be either Serial 
Channel A or B. 


The offset is optional. It tells TRSDOS-II to offset each 
load address that is specified in the incoming data (see 
"Required Data Format"). 


The offset options are: 
ADD=hhhh increments the data load address by the 
hexadecimal value hhhh 
SUB=hhhh decrements the data load address by the 
hexadecimal value hhhh 


If you omit the offset, the data loads at the address 
specified in the incoming data. 


Before uSing RECEIVE, you must initialize one of the serial 
channels with SETCOM. Select the appropriate parameters, 
depending upon the requirements of the transmitting device. 


Loading Address 


The data is loaded into memory according to the load 
information contained within the data. It must load above 
X'2FFF' and below the top of user memory. (Execute the 
SETCOM command, then use the STATUS command to get this 
latter value. ) 


If the data load address is out of this range, you can use 
the offset option to bring the load address into the 

desired range. Then, when the data is dumped into a program 
file, use the RELO= option (of the DUMP command) to specify 
the original load address. 
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Required Data Format 


The transmitting program must send the data in "Intel Hex 
Format." 


Fach byte of data is sent as a pair of hexadecimal 
ASCII-coded characters: 


ds High nibble (most significant four bits), sent as 
the first byte of pair 


Zs Low nibble (least significant four bits), sent as 
the second byte of pair 


For example, the value X'F7' is sent as two bytes, "F" 
(x! a6") followed by "7" (x'37" 2s 


Because only "." and ASCII-coded hexadecimal numbers are 
sent, the data is always in the range [X'3@', X'3A'] or 
[X'41',X'46']. Values outside this range stop reception and 
produce an error message. 

Record Format 


You must send records as follows: 


In the chart below, MSB represents "most significant bits." 
LSB represents "least significant bits." 


Character 
Number Contents Comments 
i. “EN Sync-character to indicate 
the beginning of the record. 
2 High nibble of 2-byte sequence that gives 
record length (N) the number of byte pairs 
in the record. Zero means 
3 Low nibble of 256 byte pairs follow. 


record length (N) 


Radie Shaek 


2/84 


TRSDOS-II 


Character 
Number 


TRS-80 ° 


Contents 


REFERENCE MANUAL 


Comments 


SS ES EE TD OD eS EE ORE OED SE OR CRE ED ED ED EE EE RES SEED GO ED ED OD EE ED wD ne see ome “SE we Se See ee ee oe ee ee ee ee ee ee ee ee ee ee ree ee ee eee ee eee ee woe 


High nibble of MSB 
of load address 


Low nibble of MSB 


High nibble of LSB 
of load address 


Low nibble of LSB 
of load address 


4-byte sequence that gives 
the address where the data 
is to start loading. The 
address specified must be in 
the user area [X'289%',TOP]. 
(See the STATUS command to 
locate TOP. ) 


High nibble of LSB 
of EOF(end of file) 
code 


Low nibble of LSB 
of EOF code 


Byte pair that gives the 
EOF code. Any non-zero 
value means EOF (no records 
follow). A value of zero 
means records follow. 


Sb NF Z) 


ot: CN 2) 


First byte of the 
first data pair 


Second byte of the 
first data pair 


First byte of last 
data pair 


Second byte of 
last data pair 


First byte is ASCII code 
for the first hex digit: 
second byte is ASCII code 
for the second hex digit. 


Last pair of data 
characters. 


18 + (N*2) 


Lote (Nee) 


First byte of data 
checksum (high 
nibble) 


Second byte of 
data checksum 


Byte pair that represents 
2s complement of the data 
(all byte pairs after the 
A Soy Oe ot 
including, the checksum). 
Note that each byte pair is 


(low nibble) changed back to the 
original byte of data 
before it is summed. 

® 
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Sample Record: 


Character Sample Data 

Number ASCII Hex Value 
l we 3A 
2 ug 39 
3 non 32 
4 nou 32 
5 ngu 38 
5 ug 39 
7 ng 39 
8 won 30 
9 Be 30 
19 nae 33 
11 1 37 
12 se he 37 
13 "8 39 
14 ma 41 
ES so 33 


This record contains two byte pairs of data: 


"3" "7" representing the value X'37' 
"7" "9" representing the value X'7Q@' 


and starts loading at X'289M'. The 1l-byte sum of the 
original bytes (represented in pairs by characters 2 through 
13) is X'5D'. The 2s complement of X'5D' is X'A3' -- which 
is represented by Bytes 14 and 15. 


Examples 

First, initialize Serial Channel A with the desired settings 
and establish a connection with the sending device. You know 
that the data load address is above X'2FFF' and below the 
top of user memory. (See the STATUS command to locate the 
top of user memory.) 

To begin the reception, type: 


RECEIVE {CH=A} <ENTER> 
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Tf the connection is "good," your computer displays: 
Ready to receive #= 


The sending device now begins to transmit. The number of 
the current record is displayed after #=. When the 
transmission is complete, you should see: 


START ADDRESS=hhhh LAST ADDRESS=hhhh 
TRA ADDRESS=hhhh 
TRSDOS-II Ready 


In each case, hhhh is the corresponding 4-digit hexadecimal 
number, 


The code is in the memory area specified in the data itself. 


Now, you can use the DUMP command to create a program file 
on diskette. 


When you initialize Serial Channel B with the correct 
parameters, you can establish a connection with the sending 
device. If the load address is X'28@@' and the end address 
is X'37FF', you must add X'@8#@' to the load address so the 
receive program is not overlaid. To do this, type: 


RECEIVE CH=B ADD=%89@ <ENTER> 


This command causes the data to be loaded, starting at 


X'2880' + X'P8PH' = X'3GPH'. 


After receiving the data, you want to dump it into a program 
file called PROGRAMI. Type: 


DUMP PROGRAM] START=399@@ END=3FFF RELO=289@% <ENTER> 


Notice that the RELO= option resets the load address to its 
original value (its value before the data was transmitted). 
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RENAME Library Command 


RENAME filespecl TO filespec2 


Changes a file's name and extension from filespecl to 
filespec2. 


RENAME does not change the file's password, contents or 
position on the disk. (See the ATTRIB command to change the 
password. ) 
Examples 

RENAME BACK/LST TO NEWLIST/1 <ENTER> 
renames BACK/LST to NEWLIST/1. 

RENAME REPORT/AUG:3 TO REPORT/SEP <ENTER> 


renames REPORT/AUG on Drive 3 to REPORT/SEP. 
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RESET Library Command 
RESET 


Resets and restarts TRSDOS-II. 

This command is almost identical to using the RESET switch. 
If your computer is capable of generating sound, RESET turns 
off the sound. 


Example 


RESET <ENTER> 
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RESTORE source TO destination {options} 


Retrieves from floppy diskettes any files stored in 
compressed form by the SAVE command. Because SAVE stores 
files in a special format, RESTORE is the only way to return 
these files to the hard disk drive. 


Note: For your convenience, please read Appendix 
F before continuing with the RESTORE entry. 


The source specifies a floppy diskette and is one of the 
following: 
filespec that must include a drive number 
wildcard:drive 
drive 


In source specifications, drive is a drive number 
from 1-3 for floppy drive systems or §-3 for hard disk 
systems. 


The destination is optional. It can be one of the 
following: 

drive 

filespec:drive Use if {options} is {IND}. 


In destination specifications, drive is a drive 
number from %-7, but it cannot be the same as the 
source drive number. 


If you specify DIR, you cannot specify a destination. 


If you omit the destination, TRSDOS-II uses the first 
available disk drive. 


If both the source and destination are drive, all user 
files are restored. 
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The options are: 
ABS retrieves the specified files. If you use this 


option, TRSDOS-II overwrites any existing file 
of the same name. If you omit the option, 
TRSDOS-II prompts you to ready the source and 
destination diskettes and it prompts you 
before overwriting. 

DIR displays the dataset directory and identifier, if 
Volume @ is in the source drive. If Volume 9g 
is not in the source drive, TRSDOS-II displays 
only the dataset identifier. 

IND (indirect) specifies the destination as an 
indirect file, the contents of which are used as 
a list of destination filespecs. 

KILL deletes the destination file before it opens 
the file for restoring. 

PROMPT asks for verification of each file for 
restoring. Press <Y>, <N>, <Q>,. or <S> (tor 
'vyesg." " no," “quit,” or “stop prompting and 
continue"). 

PRT sends the directory listing to the printer. Use 
only with the DIR option. 

SYS retrieves all system files, including system 
(language) and applications programs. If used 
with DIR, SYS lists the directory of system files. 


RESTORE reads information from a dataset created by SAVE. 
If you enter a volume of this dataset out of sequence, 
TRSDOS-II informs you of the mistake. The system also 
informs you if you accidentally enter a volume from a 
different dataset during a RESTORE. 


Note that the TRSDOS-II diskette must remain in Drive @ on 
floppy drive systems. Also, single-drive saves and 
restores are not allowed. For example, RESTORE :1 :1 is 
illegal. 


When you're restoring files in a dataset, TRSDOS-II prompts 
you with: 


Mount NEXT Diskette in Drive n -- Press ANY Key to continue. 


which instructs you to enter the next volume of the dataset. 
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Examples 
RESTORE @ TO 4 <ENTER> 


retrieves all saved non-system files on Drive @ and puts 
them in Drive 4. 


RESTORE !:2 TO 4 <ENTER> 


retrieves all saved non-system files, with and without 
extensions, from the floppy diskette in Drive 2 and puts 
them on the hard disk in Drive 4. 


RESTORE 1 PROGRAMS {IND} <ENTER> 
where PROGRAMS is an indirect file containing the files: 


MAILIST/PRG: 4 
MAILDAT/TXT: 4 
CHANGES /TXT: 4 


retrieves the files from the floppy diskette in Drive 1 and 
puts them in the filespecs, defined in PROGRAMS, on hard 
disk Drive 4. Note that "TO" is optional. 

RESTORE */SRC:8 4 <ENTER> 


retrieves all Drive @ user files that have the extension 
/SRC and puts them on hard disk Drive 4. The filenames stay 
the same. 


RESTORE 21. {DIR; PRT} 


sends the directory of the floppy diskette in Drive 1 to the 
printer. 
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SAVE Utility Program 
SAVE source TO destination {options} 


Creates a file-by-file backup of the source onto the 
destination. 


You must have at least two drives to use the SAVE command; 
the source and destination drives cannot be the same. 


Note: For your convenience, please read Appendix 
F before continuing with the SAVE entry. 


The source is one of the following: 
drive (You must specify ALL if you use drive.) 
filespec if {options} is {IND}. The filespec 
must include a drive number. 
wildcard:drive 


In all source specifications, drive is a drive 
number from 9-7. 


The destination specifies a floppy drive and is: 
drive specifies a drive number from 1-3 for floppy 
disk systems and 9-3 for hard disk systems. 


The options are: 

ABS overwrites, without prompting, any data already 
on the destination diskette. If you omit this 
option, TRSDOS-II prompts: Destination Diskette 
Ready? 

DC value date compares the creation date of each 
Specified source file against the date specified 
and saves the file, if all other criteria are met. 

DM value date compares the last modification date 
the same way DC compares the creation date. 

IND (indirect) specifies the source as an indirect 
file, the contents of which are used as a List Of 
source filespecs. 

PROMPT asks for a file verification before saving. 

You may respond by pressing <Y>, <N>, <Q>, or <5? 
(for. "yes," “no; “quit,” or “stop prompting == 
continue"). 


Radie Shaek 


2793 


TRSDOS-II TRS-80 ° 


REFERENCE MANUAL 


ALL saves all user files. If you use drive as 
the source, you must use ALL. 

SYS saves all system files, including language and 
application programs. 


Note: value is one of the following: 
< where < means less than or equal to 
> where > means greater than or equal to 
= where = means equal to 


The date must be in the form: mmddyy. 

Examples 

There is a variety of ways to use SAVE. The simplest is: 
SAVE 1 TO 2 {ALL} <ENTER> 

This copies all the files from Drive 1 into a compact form 

on the diskette in Drive 2. 

Wildcarding 


Wildcards also offer an easy way to save several files or an a 
entire disk. For example: 


SAVE */CBL:4 TO @ <ENTER> 


saves all Drive 4 files with the extension /CBL and puts 
them on the diskette in Drive @. 


Using the IND Option 
The indirect option lets you save groups of files by 
creating an indirect file, a file consisting of one or more 
filespecs (Similar to a DO file). You can use the BUILD 
command to create this list of filespecs. 
At TRSDOS-II READY, type: 

BUILD PROGRAMS: <ENTER> 


This creates an indirect file called PROGRAMS. 
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After TRSDOS-II prompts you with: 


Enter command line (1-89) 


Enter your list of file specifications including drive 
numbers, for example: 


ORDERS:5 <ENTER> 
REPORTS /*:6 <ENTER> 


To exit the BUILD and return to TRSDOS-II READY, press 
<BREAK>. 


You are now ready to save the files (specified by the 
indirect file) to the specially formatted floppy diskette. 


Type: 
SAVE PROGRAMS: TO 1 {IND} <ENTER> 


Both ORDERS and REPORTS are now found in the file named 
PROGRAMS on the diskette in Drive @ and saved to the 
diskette in Drive l. 


Note: The IND option lets you save more than one file 
from each hard disk; it also lets you save from more than 
one hard disk. As a result, you might save multiple files 
that have the same name. Because the save and restore 
directory does not specify drive numbers for files, you 
could lose duplicate filenames. 


For example, if you created an indirect file that has these 
files: 


* /FOR: 4 
* /CBL: 4 
*/FOR:5 


Drives 4 and 5 may have duplicate filenames with the /FOR 
extension. Before you use indirect, examine all the files 
to be saved. Rename any duplicate filenames or before 
Saving or create different datasets. 
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Using the DC and DM Options 


Another way to save files is to do so with respect to their 
creation or modification (update) dates. For example, 
Suppose your directory showed these creation and update 
dates for your files: 


Filename Created Updated 
MENU/PRG 6/1/81 9/2/81 
PRGONE/PRG 6/1/81 8/16/81 
PRGTWO/PRG 6/1/81 7/38/81 
PRGTHR/PRG 6/1/81 6/16/81 
PAYROLL/DAT 9/15/81 19/15/81 
CHECKS /DAT 9/15/81 19/15/81 
TEST/PRG 19/29/81 19/29/81 


If you want to save only those files created on June l, 
1981, use the following command: 


SAVE */*:5 TO @ {DC=969181} <ENTER> 


The first four files are saved to the floppy diskette in 
Drive @. 


In the same sense, the first four files were updated on or 
before September 2, 1981 (9/2/81). Type: 


SAVE */PRG:5 TO @ {DM<#99281} <ENTER> 


and all files updated on or before the specified date are 
saved. 
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SCREEN Library Command 
SCREEN 


Copies all of the current screen display to the printer. 
Graphics characters are printed as periods and reverse 
(green/white-on-black) alphanumeric characters are printed 
as normal (black-on-green/white) characters. 

Example 


To copy the current command line to the printer, type: 


SCREEN <ENTER> 
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SETCOM {options} 


Sets up Serial Channels A and B (on the back panel) for 
communicating with a remote device, via a modem or hardwire 
connection. 


If you are not a machine-language programmer and want to 
communicate with a remote device, you can either use the 
HOST program or buy a communications program. The manual 
that comes with the communications program explains how to 
use it. See your Radio Shack store for information. 


The options are: 
A=OFF turns off Channel A's RS-232C Communication 
settings 
B=OFF turns off Channel B's RS-232C Communication 
settings 


A=(baud rate,word length,parity,stop bits) 


sets up Channel A for RS-232C Communication 
B=(baud rate,word length,parity,stop bits) 


sets up Channel B for RS-232C Communication 


If you omit all options, TRSDOS-II displays the status of 
both channels. 


The RS-232C settings can be the following: 


baud rate 119, 158, 300, 600, 1299, 2490, 4809, 
969%. If you omit the setting, 39M is 
used. (Some programs do not run 
correctly at speeds higher than 2499 


baud. ) 

word length 5, 6, 7, 8. If you omit the setting, 7 
is used. 

parity Ey © > Oc N (for “even,” "odd," ‘cor 


"none"). If you do not specify the 
setting, even is used. 
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stop bits 1, 2. If you do not specify the 


setting, 1 is used. 


You must put a comma after every option but the last. The 
options are positional. For example, the third item in an 
option list must always specify parity. To use a default 
value, omit the option and insert only the comma. 


To change the settings on a currently active channel, first 
turn off the channel. 


Before executing this command, connect the remote device to 
Channel A or B. 


Then, after executing it, you can begin sending and 
receiving data, using one of these TRSDOS-II supervisor 


calls. (See the "Technical Information" section for 
details.) 
Name SVC Number Function 
ARCV 96 Channel A receive 
ATX G7 Channel A transmit 
ACTRL 19 Channel A control 
BRCV 98 Channel B receive 
BTX 99 Channel B transmit 
BCTRL 191 Channel B control 


These system routines are available only when the respective 
channel has been initialized. (See "Technical Information" 
for details.) 


Examples 
SETCOM A=( ) <ENTER> 


sets up Channel A for serial communications, using all the 
default parameters. TRSDOS-II function calls 96 and 97 
(ARCV and ATX) are available for serial input/output. The 
status of Channel B remains the same. 
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SETCOM B=(60@,8,,2), A=OFF <ENTER> 


sets up Channel B: 


baud rate 608 

word length 8 bits 

parity even (default) 
stop bits 2 


and turns off Channel A. 


SETCOM A=(1299,8,0,), B=(,,,2) <ENTER> 


sets up Channels A and B. 


Setting Channel A Channel B 
baud rate 1299 388 (default) 
word length 8 7 (default) 
parity odd even (default) 
stop bits 1 (default) 2 


SETCOM <ENTER> 
displays the status of both channels. 
SETCOM A=OFF, A=( ) <ENTER> 


resets Channel A to the default parameters. 
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SPOOL {options} 


Captures printer output or prints a spool file. 


SPOOL increases the efficiency of the system by letting you 
use the system while a print operation is in progress. 


The options control the spool function. They are: 

ON turns on SPOOL. You must set this switch before 
you can use the other options. 

OFF turns off SPOOL and closes the capture file and 
print file. 

N,F=filespec creates a capture file named filespec. 

P,F=filespec begins background printing of filespec. 

K keeps the file after printing it. If you omit this 
option, TRSDOS-II deletes the file after printing 
it. (TRSDOS-II won't delete a print file if the 
file is closed by a SPOOL S or if a disk error 
occurs in the print file.) 

C=number specifies the number of copies you want. 

The number can be from 1-255. If you omit this 
option, TRSDOS-II makes one copy. 

L=line specifies the line number at which printing 
Starts. The line may be any number from 
1-65535. If you omit this option, printing begins 
at Line l. 

H halts background printing but saves the current 
position for later resumption (R option). 

R,L=line resumes background printing after a halt 
(H option), or displays the current line number if 
the spooler has not been halted. If you use 
R,L=line, printing resumes at the specified 
line. If you use only R, printing resumes at the 
point where it stopped. 

S stops printing. It closes but doesn't kill the 
print file and leaves the capture file open. 


Tf you omit all options, TRSDOS-II displays the SPOOL 
status. 
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SPOOL performs two functions which you can use at the same 
time or one at a time: 


Example 1 


It saves or "captures" the data that normally goes 
to the printer. The spooler then can either throw 
away this captured data or save it ina 

capture file for later use. 


It prints data from a disk file while other 
operations are in progress. That is, you can use 
the system -- everything except the printer -- 
while printing the file. While the spool file is 
printing, your system captures the real-time 
printer output for later use. 


Capture File 


In this example, you can run a program that outputs to the 


printer. 


Instead of waiting (until printing is complete) to 


use your system, you can capture the program ina disk file 
to print out later. 


To do this, call the capture file SPOOL1 and type: 


SPOOL ON <ENTER> 
SPOOL N,F=SPOOL1 <ENTER> 


This saves all printer output in SPOOL1. To stop capturing 
the printer output in SPOOLI1, type: 


SPOOL OFF <ENTER> 


Now SPOOL] is a text file which you can list or print in the 
normal means, at your convenience. 
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Example 2 
Background Printing 


Here you can print to a file created by SPOOL while you use 
the system. Using the SPOOL] file from the first example, 


type: 


SPOOL ON <ENTER> 
SPOOL P,F=SPOOL1 <ENTER> 


TRSDOS-II begins printing the file as a "background task." 
Printing takes place only when the system isn't busy with 
some higher priority operation, such as interpreting and 
executing your keyboard commands. Because this example 
doesn't include the K or C= option, TRSDOS-II prints only 
one copy and then deletes SPOOLI. 


After completing the print file, the spooler doesn't turn 
itself off. Type: 


SPOOL OFF <ENTER> 


Example 3 
Simultaneous Capture File and Background Printing 


To save real-time printer output while SPOOL prints a file, 
you can use this example. 


You need one capture file (SPOOL1) and one print file 
(SPOOL2). 


To turn on SPOOL, create the capture file (SPOOL1), and 
begin capturing printer output in it, type: 


SPOOL ON <ENTER> 
SPOOL N,F=SPOOL1 <ENTER> 


You can now use the computer normally. Then, when you're 
ready to print out SPOOL1, close the file and make SPOOL2 
the new capture file. Do this by typing: 


SPOOL N,F=SPOOL2 <ENTER> 
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To print SPOOL1 and save any real-time printing in SPOOL2, 
type: 


SPOOL P,F=SPOOL1 <ENTER> 
If you want to halt the print-file operation, type: 
SPOOL H <ENTER> 


This doesn't affect the capture-file operation. To resume 
printing, type: 


SPOOL R <ENTER> 
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STATUS Library Command 
STATUS 


Displays system status information. 

This command tells you the first address of protected 

high memory (non-user memory) and lists the on/off status of 
active TRSDOS-II functions. 

Example 

To locate the top of user memory, type: 


STATUS <ENTER> 


and subtract 1 from the value displayed. 
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f Library Command 


Moves the printer to the next page (top of form). This 
command does the same as FORMS with the T option. 


If you are using SPOOL and it is capturing, T sends 
top-of-form character X'@C' to the capture file. 


Example 
T <ENTER> 


advances printer to the next top of form. 
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TERMINAL Utility Program 
TERMINAL 


Transforms your computer into a "terminal" to another 
computer's "host" program. You can use TERMINAL for 
transmission and reception of ASCII text only. You cannot 
use it for machine-language object code. 


Communication takes place through Serial Channel A. [In most 
applications, you can hook up the computers through 
telephone lines via a modem. 


TERMINAL's three modes of operation, all of which are 
described in detail in "Modes of Operations" are: 


. Menu -- Lets you select TERMINAL'sS menu commands, 
switch command options (such as "on" and "off"), 
and execute TRSDOS-II library commands. 


; Interactive Terminal -- Transmits your keyboard 
input and displays incoming data. 


‘ Transmit from RAM -- Transmits prepared data at 
high speeds. Incoming data is displayed. 


Setting Up 


For communication through telephone lines, you need a modem 
such as the Telephone Interface II (26-1171), Modem I 
(26-1172), or Modem II (26-1173), and the RS-232C Cable 
(26-4493). 


dais Set up the modem according to its instructions and 
connect it to Serial Channel A on the back panel of the 
computer display console. 


2% Set the modem to either the originate or the answer 
mode -- whichever is the opposite of the host program 
with which you are going to communicate. Set it to 
full or half duplex, again depending upon the 
requirements of the the host program. 
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Turn on the modem and the computer system. 


Find out which RS-232C parameters (SETCOM) are required 
by the host program you plan to use: 

Baud rate 

Word length 

Parity 

Number of stop bits 


Initialize Serial Channel A accordingly (see "Running 
Terminal" below). 


In some of the examples showing uses of TERMINAL, charts are 


used. 


These show the prompts you see on the display and 


what you should type in response. 


Running Terminal 


i 


From TRSDOS-II Ready, start TERMINAL by typing: 
TERMINAL <ENTER> 


The program starts up in the menu mode with the 
prompt : | 


-- Enter Menu Selection .. 


Initialize Serial Channel A according to the 
requirements (baud rate, word length, parity, and 
number of stop bits) of the host program with which 
you are going to communicate. Type: 


S <ENTER> 


When the program prompts you to type in a TRSDOS-II 
command, type in the SETCOM command just as you would 
in the TRSDOS-II Ready mode. For example: 


SETCOM A=(39%,7,N,2) <ENTER> 
enables Serial Channel A with 39@ baud, 7-bit 
words, no parity and 2 stop bits. After TRSDOS-II 


executes the command, control returns to TERMINAL'S 
menu mode. 
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ce If you plan to use the TERMINAL printer command (P), 
which is described later, initialize the printer now 
with the FORMS command. Type: 


S <ENTER> 
and enter the appropriate FORMS command at the prompt. 


4. To select another menu command, type in the letter 
specified in the menu. (See the "Menu Commands" 
section below for a list of options.) To redisplay the 
entire menu, type: 


M <ENTER> 
Modes of Operation 


Menu Mode 


The only mode from which you can select menu commands. It 
also lets you enter one of TERMINAL's other modes -- 
transmit from RAM or interactive terminal. The menu mode is 
an off-line mode (you cannot transmit characters to the host 
program, and if characters are sent to you, they are lost). 


Interactive Terminal Mode 


Sends to the host program the characters you type and 
displays incoming characters as they are received. If the 
host program echoes your transmissions, they appear on the 
display. If not, you can select the self-echo option to 
display your keyboard input. 


Using the R command, you can save incoming characters 
temporarily in the RAM buffer. Then, you can use the P 
command to output them to the printer. 


If a transmission error occurs, TERMINAL displays an error 
message and waits for you to correct the error condition. 
(See "Error Conditions" at the end of the TERMINAL entry.) 
After you do, normal input/output resumes. There are three 
ways to enter the interactive terminal mode: 
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e With the T command from the menu mode 
. With the O command, upon completion of an auto 


Sign-on (menu mode) 
‘ After transmission from the RAM buffer 
To return to the menu mode, press <BREAK>. 


Note: Certain hosts prompt you to use a break 
character or sequence to initialize transmissions. 
Since the <BREAK> key sends the program from the 
interactive mode to the menu mode, TRSDOS-II uses 
<ESC> as the break character. You can also set 
your own break character or sequence with the B 
command. 


Transmit from RAM (and Auto Sign-On) 


Sends the contents of the RAM buffer to the host program and 
passes control to the interactive mode. 


Auto sign-on (O command) works the same as transmit from 
RAM. (The following applies to both operations. ) 


To load the RAM buffer with prepared text from a disk file, 
use the G command. (If you are using auto sign-on, your 
auto sign-on message is sent.) You can send the data in the 
RAM buffer one line at a time when the host program prompts 
you that it is ready (W command), or you can send it ina 
continuous stream. 


During transmission, your computer displays incoming text. 
If the host program echoes your transmissions, you can 
verify that the data. .was sent accurately. 


During transmission, adjust the delay between characters by 
repeatedly pressing the <up arrow> (faster) and <down arrow> 
(Slower) keys. If echoed data appears garbled, slow down 
the transmissions. If it is coming too slowly, speed it up. 


If TERMINAL receives a break character or sequence in this 
mode, it pauses until it receives the next character. If it 
receives an X'13', TERMINAL pauses until it receives an 
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X'll1l'. (By convention, X'13' is called the DC3 signal and 
means pause. X'1ll' is called the DCl signal and means 
resume). 


Use the X command to enter this mode, 


To exit this mode and return to the menu mode, press 
<BREAK>. 


Menu Commands 


A Build Auto Sign-On Message -- Lets you prepare an 
automatic sign-on message that contains your responses to 
the standard sign-on questions asked when you first call a 
host. By sending this automatic message to the host via the 
O command, you avoid repeating your responses each time you 
call the host. 


The message can be up to 6@ keyboard characters, including 
control characters. All control characters are displayed as 
+, but the true control code is sent. (When you display a 


message, no control codes are shown.) To imbed a carriage 
return in the message, press <down arrow>. 


For example, if the host asks these sign-on questions: 


User ID? 
User Password? 
Program Name? 


and you want to store these responses in the auto sign-on 
buffer: 


STL-314 <X'@D'> 
SHOWME <X'@D'> 
MENU <X'@D'> 


answer the prompts as follows: 


Radice Shaek 


27111 


TRSDOS-II TRS-80 ® REFERENCE MANUAL 
Prompt Type 
—- Enter Menu Selection .. A <ENTER> 
The Current Auto Sign-On is 
Change? (Y/N) .. Y <ENTER> 
Enter Auto Sign-On Message (1-69) STL-314 v SHOWWEV MENU <ENTER> 
The Current Auto Sign-On is 
STL-314 
SHOWME 
MENU 


On the display, there is a blank line below the prompt "The 
Current Auto Sign-On is." This indicates that the original 
auto sign-on was blank or contained non-display characters. 


B Set/Change Break Character or Sequence -- Lets you 

select the incoming code that is to be interpreted as a 

"break." It also lets you define a key to send the same 
break character or sequence. 


You can use any code from 9-255 as the break character and 
any duration from 1-451 milliseconds for the break sequence. 
(This is determined by the host program.) For the 
user-defined break key, you can use any key except <BREAK> 
Or <CTRES <CA7% 


The following example shows how to set up X'@A' as the break 
character and <CTRL> <D> as the break key: 


Prompt Type 

——- Enter Menu Selection .. B <ENTER> 

Break Key is Now 1B Hex 

Change? (Y/N) .. Y <ENTER> 

Enter New Key (1) <CTRL> <D> <ENTER> 


Break Key is Now #4 Hex 
Type of Break is Now CHR 


Change? (Y/N) .. N <ENTER> 
Break Char is Now @3 Hex 

Change? (Y/N) .. Y <ENTER> 
Enter New CHAR Value in Hex (2) QA <ENTER> 


Break Char is Now @A Hex 
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C Copy RAM Buffer to Disk -- Creates a disk file copy 


of the text in the RAM buffer. The new file has a record 
length of l. 


Use this command to save data received into the RAM buffer 
in the interactive terminal mode. To minimize hookup time, 
do this after ending the connection to the host program. 

Or, if the RAM buffer is full, save the data in a disk file, 
then reset it and reopen it for more data. 


For example, to save a report (that you receive in the 
interactive terminal mode) as a disk file named REPORT, 
answer the prompts as follows: 


Prompt Type 
— Enter Menu Selection .. C <ENTER> 
Enter Filespec (1-34) REPORT <ENTER> 


This creates the new file but leaves the RAM buffer contents 
and status unchanged. If REPORT exists, the new data 
overwrites it. 


To stop the copy process, press <BREAK>, which closes the 
disk file and returns to the menu. 


D Display RAM Buffer -- Displays the contents of the 
RAM buffer. To pause the display, press <HOLD>. To 
continue, press <HOLD> again. If the printer command is on 
when you issue this command, the text is output to the 
printer, also. To enter the command, type (at the Enter 
Menu Selection prompt): 


D <ENTER> 


To stop the display function, press <BREAK>. The menu 
returns. 


E Self-Echo -- Lets you display the characters you 
send via TERMINAL. 


Some hosts echo the text you send. As the host receives 
each character, it sends it right back to you and displays 
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what you sent. When communicating with this kind of host, 
set your modem to full duplex. 


If the host does not echo your text, you must use the 
self-echo command to display the text you send. With such a 
host, set your modem to half duplex. 


To switch the echo option (on or off), simply type E 
<ENTER>. The new state of the option is displayed, and the 
menu prompt returns. 


F Set/Change <Fl> and <F2> Keys -- Lets you set <Fl> and 
<F2> to output any code from §-255. This is useful if you 
use a particular code often. 


For example, if the host recognizes X'13' (<CTRL> <S>) as 
pause control and X'1ll' (<CTRL> <Q>) as resume control, you 
may want to change these to <Fl> and <F2> for convenience. 
To do this, answer the prompts as follows: 


Prompt Type 

——- Enter Menu Selection .. F <ENTER> 
Fl Key Will Send a 91 Hex Code 

Change? (Y/N) .. Y <ENTER> 


Enter New Char Value in Hex (2) 11 <ENTER> 
Fl Key Will Send a 11 Hex Code 
F2 Key Will Send a @2 Hex Code 
Change? (Y/N) .. Y <ENTER> 
Enter New Char Value in Hex (2) 13 <ENTER> 
F2 Key Will Send a 13 Hex Code 


Now when you press <Fl> while in the interactive terminal 
mode, TERMINAL transmits the resume control X'll'. When you 
press <F2>, it transmits the pause control X'13'. 


G Get Disk File into RAM Buffer -- Lets you load (into 
the RAM buffer) text that is stored ina disk file. Then, 
you can send the text to the host via the X command 
(transmit from RAM). The previous contents of the RAM 
buffer are lost. 
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The disk file can contain fixed-length or variable-length 
records of any length. However, you should load and send 
only ASCII files. You can send any programs, if you saved 
them in ASCII format. 


For example, to send a document stored in the file 
DOCUMENT/TXT, answer the prompts as follows: 


Prompt Type 
— Enter Menu Selection .. G <ENTER> 
Enter Filespec (1-34) DOCUMENT/TXT <ENTER> 


TERMINAL loads the file and returns to the menu. It closes 
the RAM buffer. 


Now, if the host program is ready to accept data, you can 
use the X command to send the data. After transmission, 
TERMINAL goes to the interactive terminal mode. 


L Line Feed -- Tells TERMINAL how to handle an incoming 
line feed (X'@A'). If the option is on, TERMINAL ignores 
all line feeds: if it is off, TERMINAL does not ignore them. 


This is useful if the host sends a line feed after each 
carriage return. Since the TRSDOS-II display and printer 
drivers automatically perform a line feed after a carriage 
return, the incoming line feed is redundant. The line feed 
option should be on. 


To switch the option (on or off), type L <ENTER>. The new 
state of the option is displayed, and the menu prompt 
returns. 


M Display Menu -- Clears the display and redisplays the 
menu. Use this when you have entered so many commands that 
not all of the menu commands are visible. 


O Enter Terminal Mode with Auto Sign-On -- Starts 
transmission of the current auto sign-on message. After it 
sends the message, TERMINAL enters the interactive terminal 
mode. 


To stop transmitting the auto sign-on, press <BREAK>. This 
returns control to the menu. 
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For details, see "Transmitting from RAM." 


Note: Most host programs cannot receive anything until 
they send the first prompting message. Because of this, you 
should: 


iw Go to the interactive terminal mode (T commmand) 
when connection is first made and wait for the 
host to send its first prompt character. 


oe Press <BREAK> to return to the menu. 
ce Start the auto sign-on (O command). 


P Printer -- Switches the printer option (on or off). 
When the option is on, incoming text is copied to the 
printer. Initialize the printer with the FORMS command 
before you use the P command. When you use the D command 
while the P option is on, the RAM buffer text is copied to 
the printer. 


TERMINAL uses a circular buffer for efficient output to the 
printer. If characters overflow the buffer, they may not be 
printed. They are displayed, however, and saved in RAM if 
the buffer is open. (Check your printer's specifications for 
the maximum character input rate. At 39M baud, 7-bit 
characters may come in as fast as 38 per second.) 


TO minimize hookup time, keep the P option off while on-line 
with the host. Save the incoming text in RAM, and upon 
completion of the hookup, turn on the P option. Then use the 
D command to get a hard copy of the data. 


To switch the printer option, type P <ENTER>. The new state 
of the option (on or off) is displayed and the menu prompt 
returns. 


Q Quit -- Returns control to TRSDOS-II. If there is 
data in the RAM buffer, it is lost. (You cannot restart 
TERMINAL and recover lost data. ) 


R RAM Buffer -- (interactive terminal mode only) Lets 
you save in RAM some or all the data received by "opening" 
and "closing" the RAM buffer. Later, you can use the D 


command to examine the data. Or, you can use the C command 
to save the data ina disk file. 
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When you open this area of memory known as the RAM buffer, 

you can either reset it or retain its current contents. If 
you retain the contents, new incoming text is loaded after 

existing text. 


To switch the RAM buffer option (open or closed), type R 
<ENTER>. The new state of the option is displayed. If you 
have just opened the buffer, you receive the following 
prompt: 


RAM Buffer Now Open 
Reset RAM Buffer? (Y/N) .. 


If you type Y <ENTER>, the buffer resets and existing 
contents are lost. For more information, see "Using the RAM 
Buffer." 


S) Perform Library Command -- Enters TRSDOS-II and lets 
you enter a library command. After the command executes, 
control returns to TERMINAL's Menu. A few TRSDOS-II 
commands and programs automatically return to TRSDOS-II 
Ready. If you execute any of these commands while in 
TERMINAL, control returns to TRSDOS-II Ready, not to 
TERMINAL. 


T Enter Terminal Mode -- Directly enters the interactive 
terminal mode. When in this mode, press <BREAK> to return 
to the menu. 


V Video Filter -- Filters out data characters that 
produce undesirable results when output to the display. 


When a character such as ESC (X'1B') is output, it causes 
TERMINAL to clear the screen and home the cursor. With the 
video filter on, you can prevent this by "filtering" these 
characters from the display. If the RAM buffer is open, 
they are saved in RAM, regardless of whether the V option is 
On Or oft. 


The codes (given in hexadecimal) that this option filters 
are: 


01,02,083,84,95,86,897,9B,0C,G9E, OF, 
10, 11712 ,13514,15,16,15)1F 
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If TERMINAL receives any of these characters while the video 
filter is on, it displays a "+" in the character's place. 

To switch the option (on or off), type V <ENTER>. The new 
state of the option is displayed, and the menu prompt 
returns. 


W Set/Change Prompt-Wait Character -- Sets a special 
character as the prompt-wait character to cue the terminal 
to continue the transmission. 


This lets you use the high-speed transmit from RAM mode, 
even when the host program can accept only one line at time. 
(It does not affect operation in the interactive terminal 
mode. ) 


Normally, the host program sends a prompt, such as a 


question mark, when it is ready for the next line. (A line 
is defined as a string of characters ended by a carriage 
return X'@D'.) In the interactive terminal mode, you simply 


wait until this prompt is displayed. The prompt-wait 
feature makes TERMINAL do the same thing while in the 
transmit from RAM mode. 


You can define the prompt-wait character as any keyboard 
character from X'2@' to X'7F'. 


Leave the prompt-wait feature off when the host program is 
storing characters as received and is not sending a 
ready-for-next-line prompt. TERMINAL transmits text from 
RAM in a continuous stream. 


Note: When you start the transmit from RAM (X command) or 
auto sign-on (O command), the first line is sent 
immediately, without waiting for a prompt. After that, each 
line is sent after the prompt is received. 


To turn off the prompt-wait option, press <HOLD> when the 
program asks for a new character. 


xX Transmit RAM Buffer and Enter Terminal Mode -- Enters 
the transmit from RAM mode where it sends the current 
contents of the RAM buffer to the host program. When the 
entire buffer has been sent, TERMINAL goes into the 
interactive terminal mode. For details, see "Transmitting 
from RAM." 
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To stop transmitting from RAM, press <BREAK>. Control 
returns to the menu. 


Using the RAM Buffer 


You can use the RAM buffer to store incoming text (R 
command) and prepared text from a disk file (G command) so 
TERMINAL can send it quickly. The RAM buffer reduces costly 
hookup time by letting you perform time-consuming operations 
—— such as preparing data or printing it out -- while 
TERMINAL is off-line. 


If the buffer is filled during a load from disk (G command) 
or while receiving data in the interactive terminal mode, a 
warning message is displayed and the buffer is closed. Le 
you are loading a disk file, control returns to the menu 
mode and the buffer is filled with the data that was loaded. 


If you are in the interactive terminal mode, normal I/O 
continues, but it is no longer saved in the buffer. 


Saving the RAM Buffer 


When the buffer is filled in the interactive terminal mode 
=~ or when you think it is almost full: 


i Transmit a pause or break control character to the 
host program. 


Zs Press <BREAK> to return to the menu. 


3 Use the C command to copy the contents of the RAM 
buffer to a disk file. 


ae Reset the RAM buffer with the R command. 


Sy Use the T command to return to the interactive 
terminal mode. 
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Opening and Closing the RAM Buffer 


To save portions of the text during I/O of the interactive 
terminal mode, use the R command. Prior to receiving the 
data you want to save: 


ie Transmit a pause or break control character to the 
host program. 


Zs Press <BREAK> to return to the menu. 


3% Use the R option to switch the RAM buffer status. 
If it is closed, open it. If it is open, you may 
reset it or leave it. To add new data onto the 
end of old data, do not reset it. To delete old 
data, reset it. 


4. Use the T command to return to the interactive 
terminal mode. 


ae Direct the host program to resume transmission. 
The data is saved in the RAM buffer as it is 
received. 


Saving the Options You Have Selected 


You can save these commands in a customized version of 
TERMINAL : 


‘ Prompt wait and definition of prompting character. 

‘ Definition of break character or sequence from 
host program and assignment of a break key on your 
computer. 

° <F1l> and <F2> characters. 

. Line feed. 

‘ Printer. 

* Self echo. 

‘ Video filter. 
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‘ Auto sign-on. 
s Speed of transmit from RAM and auto Sign-on (as 


set by the "up"and "down" keys). Once you learn 
the maximum rate of transmission the host program 
can handle, you can set that as the default rate. 


After you select the options for your customized version, 
use the DUMP command to create a new program file. TERMINAL 
resides from X'39@M%'. Give this customized program a name 
other than TERMINAL, and leave the TERMINAL program in its 
original form. 


For example, to call your customized version MINE, answer 
the prompts as follows: 


Prompt Type 
— Enter Menu Selection .. S <ENTER> 
Enter TRSDOS Command (1-79) DUMP MINE START=3000, END=3FFF <ENTER> 


Now you have a customized version of TERMINAL that starts up 
when you type (at TRSDOS-II Ready): 


MINE <ENTER> 


Sample Uses 


To Send a Program -- If you intend to send a program (or 
any data) via TERMINAL, you must first store it in an 
ASCII-formatted disk file. When you have done this, set up 
the modem and initialize Serial Channel A as explained 
previously. See your modem manual for the appropriate 
procedure for getting on-line. 


For example, to send a disk file named SORTDATA on Drive l, 
get on-line and load the TERMINAL program. Enter the 
interactive terminal mode (at the Enter Menu Selection 
prompt) by typing: 


T <ENTER> 
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Go through the necessary sign-on, and when you want to send 
the program, press <BREAK> to return to the menu. CIE you 
want to use the prompt wait option, select it now.) Then 
answer the prompts as follows: 


Prompt Type 
— Enter Menu Selection .. G <ENTER> 
Enter Filespec (1-34) SORTDATA:1 <ENTER> 


TERMINAL loads the program into RAM. Make sure the host is 
ready to receive the program, then (at the Enter Menu 
Selection prompt) type: 


X <ENTER> 


The terminal now sends the program to the host. Press 
<BREAK> if you want to stop transmission for any reason, 
control returns to the menu. Otherwise, upon completion of 
the program transmission, control goes into the interactive 
terminal mode. 


To Receive a Program -- If the host program with which you 
are communicating is ready to send you an ASCII-formatted 
program, you must first go to the menu. At the Enter Menu 
Selection prompt, type: 


R <ENTER> 


If the buffer is closed, repeat this command and TERMINAL 
displays the message: 


RAM Buffer Now Open 
Reset RAM Buffer (Y/N) .. 


LYpe: 

Y <ENTER> 
This opens and clears the buffer. Use the T command to 
return to the interactive terminal mode. Then, tell the 


host to send the program. 


After you receive the program, press <BREAK> to return to 
the menu; then answer the prompts as follows: 


Radie Shaek 


2/122 


TRSDOS-II REFERENCE MANUAL 


Prompt Type 
——- Enter Menu Selection .. C <ENTER> 
Enter Filespec (1-34) NEWPROG <ENTER> 


This copies the program in RAM into a disk file named 
NEWPROG. 


Error Conditions 


In the interactive terminal mode, transmit from RAM mode, or 
during auto sign-on, TERMINAL may detect errors related to 
the serial transmission. In such cases, it displays an 
error message in reverse video and, if possible, continues 
normal I/O. 


The error messages that can occur while you are in the 
interactive terminal mode are: 


P Parity error -- The received character is 
displayed after the P. 
O Over-run -- At least one character has been 


received but not picked up by TERMINAL. This 
occurs if you are in the menu mode while the host 
program is sending characters. 

F Framing error -- The received character is 
displayed after the F. Check your SETCOM 
parameters to see that they match the requirements 
host program. 


The following errors can occur in any mode except the menu: 


DATA CARRIER LOST -- Check the telephone/modem 
connection. TERMINAL pauses until the carrier is 
restored. 

DATA CARRIER RESTORED -- If TERMINAL was 
transmitting from RAM or sending an auto sign-on, 
it starts over at the beginning of the text after 
data carrier is restored. 

BREAK SEQUENCE RECEIVED -- If the host program sends 
a break sequence, or sends TERMINAL'S own break 
character, this message is displayed. If 
TERMINAL is in the transmit from RAM or auto 
sign-on mode, it pauses until the next character 
is received from the host. 
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TIME Library Command 


TIME {hh.mm.ss} 


Lets you reset the time or display the date and time. 

hh is a 2-digit hour specification; mm is a 2-digit minute 
specification; ss is a 2-digit second specification. If you 
omit .ss, TRSDOS-II uses .@@. 


If you type TIME <ENTER>, TRSDOS-II displays the current 
date and time. The following is a sample display: 


Tha Mar 25 1982 84 == 14.15.31 


for Thursday, March 25, 1982, the 84th day of the year, 
2e15% 5. Dim, 


You first set the time when you start up TRSDOS-II. Once 
you set the time, TRSDOS-II updates the time and date 
automatically, using its built-in clock and calendar. 


If the time passes 23.59.59, TRSDOS-II does not start over 
at @0.00.8@. Instead, it continues with 24.00.0%. However, 
the next time you use the TIME or DATE command, TRSDOS-II 
converts the time to its correct 24-hour value and updates 
the date. If you let the clock run past 59.59.59, it 
re-cycles to zero, and TRSDOS-II does not update the date to 
include the 6f-hour period. 
Examples 

TIME <ENTER> 
displays the current date and time. 

TIME 13.208.9@ <ENTER> 
resets the time to 1:29:8@ p.m. 

TIME 18.24 <ENTER> 


resets the time to 6:24:0@ p.m. 
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VERIFY Library Command 
VERIFY {switch} 


Reads after each write operation to verify that the data is 
readable. If it is not readable, TRSDOS-II again tries to 
write and then read it. If it still is not readable, 
TRSDOS-II returns an error message, telling you the 
operation is not successful. 
The switch options are: 

ON sets VERIFY on 

OFF sets VERIFY off 


The switch is optional. If you omit it, TRSDOS-II returns 
the current status of VERIFY. 


TRSDOS-II starts up with VERIFY on. For most applications, 
you should leave it on. 


TRSDOS-II always verifies directory writes. It verifies 
user writes (writes of data into a file), however, only when 
VERIFY is on. 
Examples 

VERIFY ON <ENTER> 
reads after each write to verify that the data is readable. 


VERIFY OFF <ENTER> 


turns off the verify function. 


VERIFY <ENTER> 


displays the status of the verify switch. 
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Introduction 


This section explains TRSDOS-II on a technical level. It 
teaches you how to use TRSDOS-II system routines within your 
own Z-8% assembly language programs. You also may find the 
information useful in programming with BASIC or other 
languages. 


Memory Requirements 


TRSDOS-II resides on your primary drive; it occupies only a 
small portion of memory at any one time. The supervisor 
program, input/output drivers, and other essentials are 
always in memory. Auxiliary code is loaded as needed into 
an "overlay area." 


Memory addresses §-19239 (X'@@OP'-X'27FF') are reserved for 
TRSDOS-II. 


All TRSDOS-II utilities use memory in the range of X'2899' 
-X'2FFF', 


The following utilities use all of user memory: FORMAT, 
BACKUP, FCOPY {SYS} and single-drive COPY. 


You must locate user programs above X'27FF'. You may want 
to locate them above X'2FFF', so you can use the utility 
overlays without losing your program. 


Memory Requirements of TRSDOS-II 


Decimal Hex 
Address Area Address 
G-19239 TRSDOS-II Resident Area Se 
27FF 
19249- Utility Overlay Area 289 0- 
12287 2FFF 
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Decimal Hex 
Address Area Address 
12288- User Area 308 G- 
61439 EFFF 
61449- TRSDOS-II Demand Resident Area FOP O- 
65535 FFFF 
® 
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TRSDOS-II 


Video Display 


Cursor motion and allowable input characters are 


The display has two modes of operation -- scroll and 


graphics. 


des. 


different in the two mo 


Graphics Mode 


In the graphics mode, the display can be thought of as an 8% 


as illustrated below: 


by 24 Matrix; 


Bcd SSEERES Sune Sane SN SEES RR SERS SRS RE SSIES I I 
SE SES RS SR SER SR SS ee ee cee eee eae ee : 


Del eel cel el eel el oe oe oe ol 


DISPLAY POSITIONS, GRAPHICS MODE 


88 characters 
The above illustration 


The display has two character sizes 


per line and 49 characters per line. 


Note: 


shows the 8@ characters-per-line mode. 
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Each time an acceptable character is received, it is 
displayed at the current cursor position, which is set upon 
entry to the graphics-mode routines. After the character is 
displayed, the cursor position is advanced, as follows: 


If the cursor is to the left of Column 79, it advances 
to the next column position on the same row. 


If the cursor is at Column 79, it wraps around to 
Column @ on the next row. 


Cursor movement works the same way in all directions. For 
example, if the cursor is at Row 23, Column 48, and 
TRSDOS-II receives the X'FF' (graphics-down) code, the 
cursor wraps around to Row § in the same column. 
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Scroll Mode 


In the scroll mode, the display can be thought of as a 
sequence of 1928 display positions, as illustrated below: 


Line O 
Line 1 
Line 2 
Line 3 
Line 4 
Line 5 
Line 6 
Line 7 
Line 8 
Line9 
Line 10 
Line 11 
Line 12 
Line 13 
Line 14 
Line 15 
Line 16 
Line 17 
Line 18 
Line 19 
Line 20 
Line 21 
Line 22 
Line 23 


DISPLAY POSITIONS, SCROLL MODE 


Note: The display has two character sizes: 88 characters 


per line and 4@ characters per line. The illustration above 
shows the 8% characters-per-line mode. 


Each time an acceptable character is received, it is 
displayed at the current cursor position. Then, the cursor 
advances to the next higher numbered position. 


When the cursor is on the bottom line, and a line feed or 


carriage return is received, or the bottom line is filled, 
the entire display is "scrolled." TRSDOS-II: 
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Ls Deletes Line Q@ 
24 Moves Lines 1-23 up one line 
ee Blanks Line 23 
4. Sets the cursor at the beginning of Line 23 


Note: You can use the SCROLL SVC to protect Lines 
@ to 22 from scrolling. 
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Diskette Organization 


TRSDOS-II can use either single- or double-sided, 
double-density diskettes. It automatically formats each 
diskette according to its type. 


Each side of the double-sided diskette contains 77 tracks, 
numbered @-76. Therefore, you can think of the double-sided 
diskette as one diskette with 154 tracks. 

The single-sided diskette has 77 tracks on one side only. 
The sector is the basic unit of space allocation in 
TRSDOS-II. Except for Track @, each track contains 32 
sectors, numbered 1-32. Each sector contains 256 bytes. 
TRSDOS-II reserves Track @ for itself and formats it 
single-density. Track @ contains 26 sectors and 128 bytes 
per sector. On double-sided diskettes, only one side has a 
single-density Track Q@. 

The capacity of a double-sided diskette is: 


(153 * 32 * 256) + (1 * 26 * 128) = 1,256,794 bytes 


The capacity of a single-sided diskette is: 


(76. 32 * 256) 4+ CL. * 26% 128) = 625,920 bytes 


Single-sided 


Diskette Tracks Sectors Bytes 
Mi 76 2,432 622,592 
--- fi 32 8,192 
--- 4, 256 
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Cylinders Tracks Sectors Bytes 
a a L353 4,896 Lege oporo 
1 2 6 16,384 
--- 7 32 8,192 
--- --- 1 256 
® 
Radio Shaek 


3/8 


TRSDOS-II REFERENCE MANUAL 


TRS-8O °* 


Disk Files 


Methods of File Allocation 


TRSDOS-II gives you two ways to allocate disk space for 
files: dynamic allocation and pre-allocation. 


Dynamic Allocation 


With dynamic allocation, TRSDOS-II allocates sectors only 
when the file is written to. For example, the first time 
you open a file for output, no space is allocated. fThe 
first space allocation is done at the first write. 
TRSDOS-II allocates more space as required by later writes. 


With dynamically allocated files, TRSDOS-II de-allocates 
(recovers) unused sectors when you close the file. 


Pre-Allocation 


With pre-allocation, you specify the number of sectors to be 
allocated. The only way to do this is by using the CREATE 
command when you create the file. 


When the file becomes too large for the space allocated to 
it, TRSDOS-II dynamically extends (enlarges) it as needed. 


It does not, however, de-allocate unused sectors when you 
close a pre-allocated file. To reduce the size of a 
pre-allocated file you must copy it to a dynamically 
allocated file. The COPY command does this automatically 
when the destination is a dynamically allocated file. 


Record Length 


TRSDOS-II transfers data to or from a diskette one sector 
(256 bytes) at a time. These data blocks are called 
"physical records." 


TRSDOS-II transfers data to or from a file in buffers which 
are from 1 to 256 bytes long. These buffers are called 
"user records" or "logical records." 


Radie Shaek 


TRSDOS-II REFERENCE MANUAL 


TRS-80 ° 


TRSDOS-II automatically "blocks" your logical records into 
physical records to be transferred to the disk. It also 
automatically "de-blocks" the physical records into logical 
records, which are used by your program. 


Therefore, your only concern during file access is with 
logical records. You never need to worry about physical 
records, sectors, tracks, and so on. This is to your 
benefit, since physical record lengths and features may 
change in later TRSDOS-II versions, while the concept of 
logical records will not. 


From this point on, the term "record" refers to a "logical 
record,” 


Spanning 


If the record length is not an even divisor of 256, the 
records automatically are spanned across sectors. 


For example, if the record length is 29%, Sectors 1 and 2 
look like this: 


cEcTOR —— 


record 2 
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Fixed-Length and Variable-Length Records 


TRSDOS-II files can have either fixed-length or 


variable-length records. Files with fixed-length records 
are called FLR files; files with variable-length records, 
VLR files. 


For an FLR file, you set the record length when you open the 
file for the first time. This length can be from 1-256 
bytes. You cannot change the set record length unless you 
overwrite the file with new data. 


For a VLR file, you specify the record length in a 1-byte 
length field at the start of each record. The lengths of 
records in a VLR file can vary. For example, the first 
record ina file might have a length of 32; the second 
record, 17; the third record, 25@: and so on. 


The length byte for a variable-length record indicates the 
entire length of the record, including the length byte. It 
can be from §-255. You can use l, but it has no meaning 
because no record is l-byte long. 


Examples 
A length byte of @ indicates that the record has 255 bytes 
Of data: 
Length 
Byte Data 
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A length byte of 2 indicates that the record has 1 byte of 
data: 


Length 
Byte 


one byte of data 


A length byte of 16 indicates that the record has 15 bytes 
of data: 


Length 
Byte Data 
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Record Numbers 


Records are numbered from @ (beginning of file) to 
L6x77/¢214. 


A file may contain up to 16,777,216 bytes of storage. 
Therefore, to determine the number of records a file can 
hold, use the following formula: 


16,777,216 / logical record length = number of records 
For example: 
16,777,216 / 38 = 441,505 records. 


For a file with a record length of 1, the number of records 
Cannot exceed 16,777,214. 


The record number 16777215 (X'FFFFFF') positions to the "end 
of file" (EOF), regardless of the actual number of records 
in the file. 


Record Processing Capabilities 
TRSDOS-II allows both direct and sequential file access. 


Direct access, sometimes called "random access," lets you 
process records in any order you specify. 


To get direct access to Records §-65533, you simply specify 
the record number (when using one of the direct access 
SVCs). 


To get direct access to Records 65534-16777216, however, you 
must choose the extended file access mode when you open the 

file. This mode specifies the record number in three bytes, 
letting you use the large number. 


The direct access SVCS are DIRRD (direct-read) and DIRWR 
(direct-write). 


Sequential access lets you process records in the order in 
which they are stored in the file. TRSDOS-II automatically 
accesses the record that follows the last one processed. 
When you first open the file, it accesses Record 9. 
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FLR files can be opened by either direct access or 
sequential access. 


VLR files can be opened only by sequential access. You 
cannot position to a specific record, since the varying 
record lengths make it impossible to calculate the record's 
position. 


The sequential access SVCS are READNX (read-next) and WRITNX 
(write-next). When you first open the file, sequential 
processing starts with Record §. However, you can use DIRWR 
and DIRRD to position to the EOF. 


Examples with FLRs 


Assume you have an open FLR file. Here are some typical 
sequences you can do via the file processing routines: 


, Read and/or write records in the file -- in any 
order. 
Using DIRRD and DIRWR, you can: read Record 5, 
write at the EOF, read Record 3, write Record 3, 
and so on. 


; Read or write sequentially, starting anywhere in 
the file. 
Do a DIRRD to the record at which you want to 
start. Then, do READNX or WRITNX until done. 


A Write sequentially, starting at EOF. 
Do a DIRWR to the EOF. Then, do WRITNX until 
done. 

Learn the number of records ina file. 


Do a DIRRD to the EOF. Then, use the LOCATE 
routine to get the current record number. This 
equals the number of records + l. 


Examples with VLRs 


Assume you have an open VLR file. Here are some typical 
sequences you can do via file processing routines: 
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‘ Read or write sequentially, starting at the first 
record. 
Do READNX and WRITNX until done. 


‘. Write sequentially, starting at the EOF. 
Do a DIRWR to the EOF. Then, do WRITNX until 
done. 


Note: Whenever you write to a VLR, the last record you 
write becomes the end of file (EOF), automatically. 


You cannot update a VLR file directly. You must read in the 
file and output the updated information to a new VLR file. 
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Supervisor Calls 


Supervisor calls (SVCs) are operating system routines 
available to any user program. They alter certain system 
functions and conditions; let you access files; do 
input/output to the keyboard, video display, and printer; 
and do various computations. 


The available TRSDOS-II SVCs are: 


KEYBOARD SVCs VIDEO SVCs 

KBCHAR CURSOR VDINIT 
KBINIT SCROLL VDLINE 
KBLINE VDCHAR VDREAD 
KBPUT VDGRAF VIDRAM 
VIDKEY 


PRINTER SVCs 


COMMUNICATIONS SVCs 


PCTRL ACTRL BCTRL 
PRCHAR ARCV BRCV 
PRINT ATX BTX 
PRLINE RS2Z32C 
SYSTEM CONTROL SVCs FILE ACCESS SVCs 
CLRXIT HLDKEY CLOSE LOCATE 
DATE INITIO DIRRD OPEN 
DELAY JP2DO0S DIRSET RAMDIR 
DOSCMD RETCMD DIRWR RDDIR 
ERRMSG SETBRK DISKID READNX 
ERROR SETUSR DpLGr TR RENAME 
TIMER KILL REWIND 
WRITNX 


COMPUTATIONAL SVCs 


MISCELLANEOUS SVCs 


BINDEC LOOKUP SORT 

BINHEX PARSER STCMP 

MPYDIV RANDOM STSCAN 
SOUND WILD 


Note: Appendices C and D, the SVC quick reference lists, 
summarize each SVC's function. 
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Each SVC has a function code that you use to call it. These 
codes range from @ through 127. The first 96 codes (§-95) 
are defined by TRSDOS-II. Codes 96-127 are available for 
you to define (see the SETUSR SVC). 


SVC Notation 


In this section we use the following notations: 


Notation Meaning 

RP = data Register Pair RP contains the data 

a: «A RX 2 The register pair contains a value greater 
than nl and less than n2 

(RP) = data Register Pair RP contains the address 


Of ("DOLAts to”): the data 
If the Z flag is not set, an error 
occurred 


Za 
N 

Il 
ea) 
a) 
wa) 
O 
ry 


When a range is not given in the description of the SVC, you 
can use any representable number. For example, a register 
can contain any value from §-255. 

Calling Procedure 


All SVCs are executed via the RST 8 instruction. 


ds Load the function code of the desired SVC into 
Register A. Also load any other registers that 


the SVC needs. See "Supervisor Calls." 
2% Execute an RST 8 instruction. 
a% If the function is successful, the Z flag is set 


upon return from the SVC. If the Z flag is not 
set, there is an error. Register A has the 
appropriate error code (except after certain 
computational SVCs, which use Register A to 
return other information). 


During the execution of an SVC, the SVC processor does not 
alter any memory above X'2FFF'. Only those Z-89 registers 
used to pass parameters from the SVC are changed. However, 
all the prime registers are used by TRSDOS-II; they are not 
restored. 
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Examples 


Time-Delay 


LD BC , TIMCNT > LENGTH OF DELAY 
LD A,6 * FUNCTION CODE 6 = DELAY-SVC 
RST 8 *: JUMP “TO: SVC 

; DELAY OVER-PROGRAM CONTINUES HERE 


Output a Line to the Video Display 


LD HL, MSG POINT TO THE MESSAGE 


LD B,19 ; B = CHARACTER COUNT 

LD C,@DH ; C=CTRL CHAR. TO ADD AT END 
LD A,9 ; CODE 9 = DISPLAY LINE-SVC 
RST 8 JUMP TO SVC 


JR NZ, GOTERR JUMP IF I/O ERROR 
; IF NO ERROR THEN PROGRAM CONTINUES HERE 


Get a Character from the Keyboard 


GETCHAR LD A,4 ; CODE 4 = GET CHARACTER-SVC 
RST 8 ; JUMP TO SVC 
JR NZ, GETCHAR ; DO AGAIN IF NO CHARACTER 


> CHARACTER IS IN REGISTER B 


Using the Serial Communications SVCs 
Initialization 


Before doing any serial I/O, you must initialize the channel 
you want. Use either the SETCOM library command or the RS232C 
OVC. 


Input/Output 


All serial I/O is character-oriented, Similar to keyboard 
input and video output. The main difference is that your 
program must check the communications status at various 
times. This is done to ensure that the communications link 
is in place and that data is not being lost. 
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After any attempted serial I/O, TRSDOS-II returns the 
communications status to your program in 2-88 Register A. 
The bits in the register are used individually to show the 
on/off status of various conditions. Certain bits apply to 
transmit operations; others apply to all serial I/O. 


Programming with TRSDOS-II 


This section tells you how to execute your own 
machine-language programs under TRSDOS-II. It has two 
sub-sections: 


r Program Entry Conditions -- How control is 
transferred to your program after the program is 
loaded from the disk 


j Handling Programmed Interrupts -- How to write an 
interrupt service routine for <BREAK>' key 
processing and TIMER interrupts 


To create and use a program, follow this procedure: 


a4 Enter the program into memory, using DEBUG, or via 
the serial interface channel from another device, 
or uSing an assembler and linker. 


Ze If you use DEBUG or an I/O channel to load the 
program, use the DUMP command to save the program 
aS an executable disk file, setting the load and 
transfer addresses. 


ce To run the program, input the filename to the 
TRSDOS-II command interpreter (TRSDOS-II Ready 
mode). 


Program Entry Conditions 


Upon entry to your program, TRSDOS-II sets up the following 
registers: 


BC = address of the first byte following your 
program (the first free byte for use by your 


program). 


highest unprotected memory address (the end of 


memory that can be used by your program). 


DE 


Radie Shaek 


3/28 


TRSDOS-II REFERENCE MANUAL 


TRS-8SO ° 


HL = address of the buffer containing the last 
command entered to the TRSDOS-II command 
interpreter. 


The first byte of the buffer contains the 
command line length, excluding the carriage 
return. The text of the command follows this 
length byte. For example: 


length ist byte 2nd byte nth byte 
of text ofcom- ofcom- ofcom- X’OD’ 
4 mand mand mand 


Handling Programmed Interrupts 


TRSDOS-II allows two user-programmed interrupts as described 
under SETBRK and TIMER. When either kind of interrupt is 
received (you press the <BREAK> key or the TIMER counts to 
zero), control transfers to your interrupt handling routine. 


Note: System routines called by your program or called by 
interrupt handlers can be interrupted, also. 


Upon entry to your interrupt processing routine, TRSDOS-II 
sets up the registers as follows: 
(SP) = address of the next instruction to be 
executed when the interrupt was received. 
Other registers: 
Contents are the same as they were when the 
interrupt was processed. 


Before doing any processing, you should save all registers. 
When you finish processing, restore all registers and 
execute a return to continue with the interrupted program. 


Keep the interrupt handling routines short. Ideally, the 
routine simply flags the main program that an interrupt has 
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occurred, and then returns. The main program then can 
respond to the interrupt flag when convenient. 


Always end your interrupt handler with the RET instructions 
and with all registers intact. 


TRSDOS-II is serially reusable but not always re-entrant. 
Specifically, your interrupt routine should not call 
TRSDOS-II SVCs, since under some conditions this causes 
unpredictable results. 


Program Files 


This section describes the required format and structure of 
program files. In it you'll also find a summary of the 
procedure for writing a program file using TRSDOS-II 
file-access SVCs. 


Program File Format 


A program file is stored on the diskette in blocks, which 
might look like this: 


256 Bytes 256 Bytes 


Ae CE eS 


The lengths of the blocks vary, depending on the type of 
block and the amount of information in it. The blocks must 
border each other. There can be no unused bytes between 
them. 


There are three major types of blocks: 


‘ Program data blocks -- These contain the actual 
program data, prefixed by four bytes of header 
information. 


‘ Comment blocks -- These contain documentation 
for the programmer. Comment blocks are not loaded 


or examined by the loader. Comment blocks are 
prefixed by two bytes of header information. 
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‘ Trailer blocks. Each program file ends with a 
trailer block. It marks the end of file (EOF) and 
tells TRSDOS-II what to do after the file has been 
loaded -- either to transfer to a specified 
address or to return to the caller. Trailer 
blocks are four bytes long. 


The first byte in a block identifies the block type, as 


follows: 
Contents (Hex) Block Type 
G1 Program data 
65 Comment block 
@2 Trailer block; jump after 
loading 
03 Trailer block; return to 
the caller after loading 
O02, 04, 06 - FF Reserved for TRSDOS-II use; 
the loader fails if one of 
these codes is used 
f Structure of Program Data Blocks 


Program data blocks consist of the following: 


Byte # Contents 

4: Block identifier (equals binary 1) 

2 Length (the number of bytes of program 
data plus two for the load address) 

3-4 Load address (where the following 


program data starts loading into RAM); 
it must be in the LSB-MSB format 
5-end Program data 


The length byte gives the number of bytes in the rest of the 
block -- following the 2-byte load address. This sum may 
range from 3 (the 2-byte address plus l byte of data) to 258 
(the 2-byte address plus 256 bytes of data). You must 
translate the sum into the range §-255. 
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To do this, take the number of program bytes and increment 
by two. Note that values greater than 255 "wrap around" to 
@, 1, and 2. Here is a table: 
Number of 
Bytes after Address Value for 
(program data only) Length Byte 
1 3 
2 4 
3 > 
Zoo 255 
254 g 
255 i 
256 2 
The load address tells TRSDOS-II where in RAM to load the 
data in the block. TRSDOS-II loads the bytes serially. The 
load address must allow the entire block of program data to 
load in the "user" area of RAM. 
Structure of Comment Blocks 
Comment blocks consist of the following: 
Byte # Contents 
1 Block identifier (equals binary 5) 
2 Length (the number of bytes in the 
comment ) 
3-end Comment 
The length byte gives the number of bytes in the comment 
(the number of bytes after the length itself). This sum 
ranges from §-255. 
Length Byte Comment Length 
g g 
1 1 
2 2 
255 255 
® | 4 
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Structure of Trailer Blocks 


Each program file ends with a single trailer block that 
tells TRSDOS-II what to do next: 


Jump to a specified "transfer" address 
or 
Return to the caller 


Trailer blocks consist of the following: 


Byte # Contents 

1 Block identifier (equals binary "2" or "3") 
2 Length (equals 2) 

3-4 Transfer address; it must be in the LSB-MSB 


sequence and must be in the user area of RAM 


If the block identifier equals 2, TRSDOS-II jumps to the 
transfer address after loading the program. If it equals 3, 
TRSDOS-II does not jump to the transfer address. Instead, 
it returns to the caller after loading the program, with the 
following prime registers set: 


HL' = transfer address taken from the trailer block 
DE' = address of the last usable byte 
BC' = first byte following the program just loaded 


Procedure for Writing a Program File 


Program files must have fixed-length records of length 256 
and must have the P (program) access type. You set both 

of these when you create the file, using a creation code of 
1 or 2 (see the OPEN SVC). 


The TRSDOS-II program loader treats the program file as a 
serial byte stream, independent of the record boundaries. 
The loader assumes the program blocks are "back-to-back" 
(there are no unused bytes between blocks). AS programmer, 
you are responsible for: 


i Storing the correct byte sequence in the logical 
record area. 
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2% Calling the disk write SVC (DIRWR) when each 
256-byte record is filled. Blocks can and must 
"span" sectors. The only unused bytes in the file 
are after the trailer block. See the illustration 
below. 


TRSDOS-II does not load user program below "user RAM." You 
also should make sure blocks do not load above "user RAM." 


Note: The TRSDOS-II DUMP command always writes a 
comment as the first block in the file. The 


comment contains the filespec, followed by the 
current TRSDOS-II time/date text. 


Radio Shaek 


3/26 


TRSDOS-II REFERENCE MANUAL 


TRS-8SO ° 


Illustrated Program File Listing 


ERRPRINT TYPE=F Tue Sep 16 1980 260 -- 01.12.43 PAGE 1 
BVTE Lecce co BDe oe LG 0c LBs oe Be SMe ce BF ee Ae oe Fe oe 5M oe F560 OB ee OS 6 oe Te oe TS we BOe oe BS. 2 6 9B. FS. 108 
R= 1 .SERRPRINT®S1WEDOCT 31979276 O.22.41102. wa bene Bebe cece Pew e nee Dente nner wenn eee w ewe eee eee eee ees 


LRL= 256 0245555445 33544445 233333333235 233233333020E 21 EO3Z33CCIELF33CCLIECCO4003 1 CCCODDEDADDADAAAAAABVABABBBBOOO 
546 22029E4A1 754F3403197927600E22E4 1 1 OAL OOAiIEFS63E4FD4FO8E4F D4F 9546FEDE SF 1 F2ZHF PADAAAAADABABACVAAVVVBOH 


voDDDDBBDBQBQQAaQODBBQB000000 AVAGVADAABAQVAVAAVABVABA 
DBAABADABAOVBOHHAHAHAAAAAADAAADAALAABAPAVBVOVAOYORWABHAAGAAAD 


eres ete woe ereee aces cones ernee Coney cine eene teen eee eee eee oes eres cence ence ene ceees cones coeee cents mtate comme swe emees eoeme, owe weet saoee come foecee enews ene mcm eee ee Nene See eee eee aes aces eee noes meets eens cme meee metee come cones eee ween meee memes eens scone sonad seas Geune seams sense atene seems sumer cece ee me eee ae ee ee me ee eemee anes ene te ones eee tee ene cn meee ceeee comes eoume comes cram 


BlockiD 
05 = Comment 


Length 
of Comment Block ID BI Jump 
ockiD 
01=Program pie Load. nectess 02 = Jump Trailer BON GSE 
Comment eng Program Data Length 
First Byte of Program Data 


TRSDOSNII DEBUG Program 
EF OO 21 1E EF 066 33 SE 34 CF CD 14 EF 10 F8 SE 34 CF re le Tee eer 


EF 10 CD 14 EF C9 C5 O6 4F GE @D 3E 13 CF Ci C9 OB 2B sume eee 2a eS wae 
EF20 22 08 BB BB BB BH BB 2B 22 8B BB BB BB BB BW BB errr rr eee 
EF30 20 O80 BH BB BB BB BB BB 22 22 22 BB BB BB BB 2B eewveccccccse ene 
EF 40 22 BB BA BB BH BB BB BO 22 02 OB BB BB BB BB BB errr ee ee 
EFS@ 22 28 BA BB BH BB BB BA 22 22 2B BB BB BB BB 22 Serr rr ee ee ee 
EF 60 22 BB BB BW BW BH BB AB 22 2B 2B BB BB BB BO BB ree ee ee 


EF7@ 22 2 2B BB BB BB AB BB 22 22 2 A OB BB AB 2A Terre eee ee 
PC SP SZHPNC AF BC DE HL. IX no AF* &8C* DE” HL’ 
EFQQ 2i1FE 011100 0054 EF1E EFFF 2700 0000 0000 2144 0260 2701 EFOO 
7 FP 


Jump Address 
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High-Memory Modules: Their Addresses and Uses 


As mentioned earlier, there are five high-memory modules 
that are conditionally loaded. They are DO, SPOOL, HOST, 
DEBUG and the communications drivers. They reside in high 
memory (above X'F@PH'). The approximate memory map is as 
follows: 


Module Address 
Comm drivers X'FODD' 
DEBUG X'F409' 
HOST* X'F4GG' 
SPOOL* X'F64G' 
DO* x FCSEO" 


* Cannot be used with DEBUG 
Addresses may change in future releases. 


If your application requires a large amount of RAM, you may 
need to use high memory. For example, you may have a large 
BASIC program or a machine-language subroutine that you must 
link to BASIC. In either case, you might need a full RAM 
for the BASIC program itself. You must use high memory. 

If you do use high memory, keep in mind the following: 


‘ If you use BASIC, the use of high memory gives you 
slightly less RAM for your program and variable 
storage than you had with TRSDOS. 


Upon program-load, TRSDOS-II gives X'EFFF' 
in Register DE as the high-memory address. 


If you must, you may override this limit by 
specifying this command line: 


BASIC - M:upper limit of high-RAM address 


The address to use as the upper limit must never 
exceed decimal 63487. The same rule applies to an 
applications program. 


j The use of high RAM prevents the use of certain 
high-memory modules. 
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Assume that you invoke a system function that 
loads high RAM with a module. Then, your 
application loads something on top of it. 
(TRSDOS-II cannot prevent you from overlaying an 


already loaded high-memory module.) You are going 
to have problems. (See the memory map above for 
details.) 


Be careful about overlaying the addresses of the following 
modules: 


‘ Communications drivers -- If you use a serial 
printer, do not overlay X'FOPO'-X'F3FF'. 


The code in that area must be intact if your 
application has printed output. That is when the 
comm drivers are active. Overlaying in this area 
can cause serious problems. 


‘ SPOOL -- This is another module that can be 
used by almost any application that has printed 
output. To give operator flexibility, you should 
not use the RAM area of X'F649'-X'F89M' in your 
application software. 


If you must use this RAM area, make it clear to 
the operator that he may not use SPOOL. If any 
of the spool code space is overlayed after 
TRSDOS-II has loaded the spool code in that area, 
serious problems will result. 


° HOST -- Lets a remote terminal execute your 
applications and programs as if the remote were 
local (the local keyboard and video). Again, 


using this space limits the operator's flexibility 
and causes serious problems. 


You can use the high-memory space without causing 
problems, if you plan carefully. Know what you need and 
when you need it. Then, tell the operator what to do (or 
not to do) when running your application. 


For example, assume that your application program does not 
create printed output. In this case, you do not need the 
spool or comm drivers areas (if the comm drivers are needed 
just for serial printer support). 
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To use this space, make sure SPOOL and the comm drivers are 
not active before or during the run of the application. Do 
this by starting execution of the application with a DO file 
(which resides in the top of RAM). 


In this DO file, you may turn off SPOOL and the comm drivers 
before the application is executed. Remember that you must 
turn off both Serial Channels A & B for the high-memory comm 
drivers to be inactive. 


For full operational flexibility, you should stay away from 
the high-memory areas. Then, you can use all of the 
high-memory routines during program execution. 


Future releases of TRSDOS-II may provide more features or 
routines that will use high memory. Keep this in mind when 
you design your applications. To use these features, you 
may have to update your high-memory subroutines. Consider 
the efforts required to make these program changes. Your 
program may be hard to update, or it may be hard to get 
revised copies out to the users. 
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ACTRL Function Code 199 
Control Channel A 


Performs control functions on Serial Channel A. 

TRSDOS-II sets up ARCV, ATX, and ACTRL when you initialize 
Channel A with RS232C. If you call any of these routines 
while the channel is not initialized (active), you get an 
error return code of 1 (no function code exists). 


Entry Conditions 


A = 169 
B = option switch 


Exit Conditions 
NZ Error 
B status code 


The option switch settings are: 


option 
switch Result 
g Gets the current status of the serial I/O 
(SIO) channel into Register B. 
1 Gets the current character count in the 
serial receive buffer into B. 
2 Turns on Request to Send (RTS). RTS is on 
when the channel is initialized. 
3 Turns off RTS. 
4% Starts transmitting the break sequence. 
5 Stops transmitting the break sequence. 
6 Resets the serial receive buffer count to 
zero. 
7 Resets the SIO error condition. 


* Before transmitting a break sequence, make sure the 
sure the transmit buffer is empty. As the programmer, 
you are responsible for sending the break sequence for 
the appropriate time period, as required by the 
application or host computer. 
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grouping of flags returned in Register B consists 


Meaning 

Clear to Send (CTS) is not present 

Unused 

Transmitter is busy 

Modem data carrier is not present 

Parity error is occurring in the byte that is 
being received 

Data overflow is occurring because of a byte that 
is being received 

Framing error is occurring in the byte that is 
being received 

Break sequence (extended null character) is being 
received 
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ARCV Function Code 96 
Channel A Receive 


Returns a Single character from Serial Channel A. 


TRSDOS-II sets up ARCV, ATX, and ACTRL when you initialize 
Channel A with RS232C. If you call any of these SVCs while 
the channel is not initialized, you get an error return code 
of 1 (no function code exists). 


Input Buffer 


Each channel (A and B) has an internal receive buffer to 
reduce overruns when receiving data at high speeds. This 
buffer is a first-in, first-out buffer (FIFO) which is 
established when the channel is initialized. 


When a character is received, the character and the hardware 
status code are placed in the Channel A buffer. If Channel 
A has not been initialized, no characters are received. 


An overrun occurs when a character is received and there is 
no more room in the buffer. The character that caused the 

overrun replaces the last character received. Bit 5 of the 
hardware status code is set; this indicates that an overrun 
occurred. 


When the ARCV SVC is executed, the oldest character in the 
buffer is returned to Register B; the hardware status at the 
time the character was received is returned to Register A. 


Note: When a character that caused an error is 
returned to Register B, the error is indicated in 
Register A. 
If there are no characters "waiting" in the buffer, the 
communications status returned in Register A reflects the 
current status of the serial interface. 


Entry Conditions 
A = 96 
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Exit Conditions 


A = status code 

B = character returned, if any 

NZ = Character was not received, check the status 
code 

C flag = Modem carrier was not present when you entered 
the SVC 


The 8-bit grouping of flags returned in Register A (after 
serial input) consists of: 


Bit Meaning 
4) Not used 
nf Not used 
2 Not used 
3 Modem carrier was not present 
4 Parity error occurred on the last character 
received in Register B 


5 Data is lost because of an overflow; Register B 
contains the last character 

6 Framing error occurred on the last character 
received | 

7 Break sequence (extended null character) was 
received 
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ATX Function Code 97 
Channel A Transmit 


Outputs a single character to Serial Channel A. 


TRSDOS-II sets up ATX, ARCV, and ACTRL when you initialize 
Channel A with RS232C. If you call any of these SVCs while 
the channel is not initialized, you get an error return code 
of 1 (no function code exists). 


TRSDOS-II transmits data bytes even if no carrier is 
present. You must check the status flags and Register A for 
error conditions. "Carry flag set" (C flag) means that no 
carrier is present during transmission. You may ignore this 
flag if your application does not need the carrier to be 
present. 


Register A contains status information after serial output 
(upon return from ATX). 


Entry Conditions 
A 97 
B character to be sent, (ASCII code) 


Exit Conditions 
A = status code 
NZ = Character is not transmitted, check the 
status code 
C flag = Modem carrier was not present when you entered 
the SVC 


The 8-bit grouping of flags returned in Register A (after 
serial output) consists of: 


Bit Meaning 

4) Clear to Send (CTS) was not present 

1 Not used 

2 Transmitter busy 

3 Modem carrier was not present 

4% Parity error on the last character received 

a Data is lost because of a hardware-level 
overflow 
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Bit Meaning 
6* Framing error occurred on the last character 
received 
7* Break sequence (extended null character ) 


was received 


* TRSDOS-II returns bits 4 through 7 only when it does 
not send the character. 
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BCTRL Function Code 191 
Control Channel B 


Performs control functions on Serial Channel B. 

TRSDOS-II sets up BRCV, BTX, and BCTRL when you initialize 
Channel B with RS232C. If you call any of these SVCs while 
the channel is not initialized, you get an error return code 
of 1 (no function code exists). 


Entry Conditions 


A = 191 
B = options switch 


Exit Conditions 
NZ Error 
B status code 


Valid option switch settings are: 


option 
switch Result 
cy g Gets the current status of the serial I/O 
channel into Register B. 
1 Gets the current character count in the 
serial receive buffer into B. 
2 Turns on Request To Send. RTS is on when 
channel is initialized. 
3 Turns off RTS. 
4* Starts transmitting the break sequence. 
5 Stops transmitting the break sequence. 
6 Resets the serial receive buffer count to 
zero. 
7 Resets the SIO error condition. 


* Before transmitting a break sequence, make sure the 
sure the transmit buffer is empty. As the programmer, 
you are responsible for sending the break sequence for 
the appropriate time period, as required by the 
application or host computer. 
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The 8-bit grouping of flags returned in Register B consists 
Of: 


Bit Meaning 


g Clear to Send (CTS) is not present 

1 Unused 

2 Transmitter is busy 

3 Modem data carrier is not’ present 

4 Parity error is occurring in the byte that is 
being received 

5 Data is lost because of an overflow caused by a 
byte that is being received 

6 Framing error occurred in the byte that is 
being received 

7 Break sequence (extended null character) was 
received 
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BINDEC Function Code 21 
Binary/Decimal 


Converts a 2-byte binary number to an ASCII-coded decimal, 
and vice versa. The decimal range is from @ to 65535. 


Entry Conditions 
A = 21 
B = function switch 
B = ®@: convert binary to ASCII decimal 
B # @: convert ASCII decimal to binary 


If B = # (binary to decimal): 


~ DE = 2-byte binary number to convert 
(HL) = 5-byte area to contain the ASCII decimal value 


The field contains decimal digits in the range 
[x'3@',X'39'], with leading zeroes on the left 
as needed to fill the field. For example, §9@@21 
represents 21. 


If B # @ (decimal to binary): 


(HL) = 5-byte area containing the ASCII decimal value 
to convert 


Exit Conditions 


(HL) = decimal value 
DE = binary value 
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BINHEX Function Code 24 
Binary/Hexadecimal 


Converts a 2-byte binary number to an ASCII-coded 
hexadecimal, and vice versa. The hexadecimal range is from 
X'G9OOG' to X'FFFF'. 


Entry Conditions 

A 24 

B function switch 
B = @: convert binary to ASCII hexadecimal 
B ~# @: convert hexadecimal to binary 


If B = @ (binary to hexadecimal): 


DE = 2-byte binary number to convert 
(HL) = 4-byte area to contain the ASCII hexadecimal 


value 

The field contains hexadecimal digits with 
leading zeroes on the left, as needed to fill 
the field. For example, §O@FF represents the 
number X'FF'. 


If B # @ (hexadecimal to binary): 
(HL) = 5-byte area containing the ASCII hexadecimal 


value to convert 


Exit Conditions 


(HL) = hexadecimal value 
DE = binary value 
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BRCV Function Code 98 
Channel B Receive 


Returns a single character from Serial Channel B. 


TRSDOS-II sets up BRCV, BTX, and BCTRL when you initialize 
Channel B with RS232C. If you call any of these SVCs while 
the channel is not initialized, you get an error return code 
of 1 (no function code exists). 


Input Buffer 


Each channel (A and B) has an internal receive buffer to 
reduce overruns when receiving data at high speeds. This 
buffer is a first-in, first-out buffer (FIFO) which is 
established when the channel is initialized. 


When a character is received, the character and the hardware 
status code are placed in the Channel B buffer. If Channel 
B has not been initialized, no characters are received. 


An overrun occurs when a character is received and there is 
no more room in the buffer. The character that caused the 
overrun replaces the last character received. Bit 5 of the 
hardware status code is set; this indicates that an overrun 
occurred. 


When the BRCV SVC is executed, the oldest character in the 
buffer is returned to Register B; the hardware status at the 
time the character was received is returned to Register A. 


Note: When a character that caused an error is 
returned to Register B, the error is indicated in 
Register A. 


If there are no characters "waiting" in the buffer, the 
communications status returned in Register A reflects the 
current status of the serial interface. 


Entry Conditions 
A = 98 
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Exit Conditions 


A = status code 

B = character returned, if any 

NZ = Character not received: check the status 
code 

C flag = Modem carrier was not present when you entered 
the SVC 


The 8-bit grouping of flags returned in Register A (after 
serial input) consists of: 


Bit Meaning 
4) Not used 
1 Not used 
2 Not used 
3 Modem carrier was not present 
4 Parity error occurred on the last character 
received in Register B 
5 Data is lost because of an overflow; Register B 
contains the last character 
Framing error occurred on the last character 
received 
7 Break sequence (extended null character) was 
received 
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BTX Function code 99 
Channel B Transmit 


Outputs a Single character to Serial Channel B. 


TRSDOS-II sets up BTX, BRCV, and BCTRL when you initialize 
Channel B with RS232C. If you call any of these routines 
while the channel is not initialized, you get an error 
return code of 1 (no function code exists). 


TRSDOS-II transmits data bytes even if no carrier is 
present. You must check the status flags and Register A for 
error conditions. "Carry flag set" (C flag) means that no 
carrier is present during transmission. You may ignore this 
flag if your application does not "care" whether the carrier 
is present. 


Register A contains status information upon return from BTX. 


Entry Conditions 


A = 99 
B = character to be sent (ASCII code) 
Exit Conditions 

A = status code : 

NZ = Character not transmitted; check the status 
code 

C flag = Modem carrier was not present when you entered 
the SVC 


The 8-bit grouping of flags returned in Register A (after 
serial output) consists of: 


Bit Meaning 

4) Clear to Send (CTS) was not present 

1 Not used 

Z Transmitter is busy 

3 Modem carrier was not present 

4* Parity error occurred on the last character 
received 

od Data is lost because of a hardware-level 
overflow 
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Bat Meaning 
o* Framing error occurred on the last character 
received 
7* Break sequence (extended null character) 


was received 


* TRSDOS-II uses Bits 4-7 only when it does not send 
the character. 
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CLOSE Function Code 42 
Close Disk Files 


Ends access to the file you specify. This SVC first 
writes all unsaved data to the disk, then updates the 
directory before closing the file. 


Entry Conditions 
A = 42 
(DE) = data control block of the currently open file 


Exit Conditions 
NZ Brror 
A error code 


Upon return, the filespec (except for the password) 
automatically is put back into the DCB. 
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CLRXIT Function Code 57 
Clear User Memory and Jump to TRSDOS 


Clears (writes binary zeroes to) user memory and gives 
Control to TRSPOS-L1. 


Entry Conditions 
A = 57 


Exit Conditions 
None 
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CURSOR Function Code 26 
Blinking Cursor 


Turns the blinking cursor on or off. TRSDOS-II keeps track 
of the current cursor position, whether the cursor is on or 


Ort. 
Entry Conditions 
A = 26 
B = function switch 


B = @: blinking cursor off 
B # @: blinking cursor on 


Exit Conditions 
None 
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DATE Function Code 45 
Return Date String 


Sets or returns the time and date. MTRSDOS-II returns the 
data as a 26-byte ASCII string with 8 fields. 


Contents of Time/Date string: 


Name Mon. Day Year Day Time Mon. Day 
of of of of of 
Day Mon. Year Year Week 


Represents the data "Friday, October 1, 1982, the 274th day 
of the year, 1:29:42 p.m., the tenth month of the year, the 
fourth day of the week." | 


Monday is considered day @. The date calculations are based 
on the Julian Calendar. 


Entry Conditions 


A = 45 
B = function switch 
B = @: get time/date 
B= 1: set date 
B= 2: set time 
(HL) = a dependent of the contents of Register B 


If B= 1: 


(HL) = 1f-byte buffer containing the date (The date is 
in the form mm/dd/yyyy. ) 


If B = 2: 
(HL) = 8-byte buffer containing the time (The time is 


in the form hh.mm.-ss.) 


Exit Conditions 


NZ = Error 
If B = @: 
(HL) = 26-byte buffer where the time/date are to be 
stored 
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DELAY Function Code 6 
Delay Loop 


Provides a delay routine and returns control to the calling 
program after the time you specify has elapsed. 


Background processing, such as the SPOOL printing function, 
uses this delay time. 


Entry Conditions 
A 6 


BC delay multiplier switch 
BC = ®@: the delay time is 426 milliseconds 
BC # @: the delay time is: 
6.5 * (BC - 1) + 22 microseconds. 


Exit Conditions 
None 
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DIRRD Function Code 35 
Direct-Read 


Reads the specified record of an FLR file. 


Also, you can use-DIRRD to read the first record or the EOF 
(X'FFFF') of a VLR file. 


Upon return, your record is in the’ record area pointed to by 
RECADR in the parameter list. Or, if the record length is 
256, and you are reading a fixed-length record, it is in the 
area pointed to by BUFADR (see the OPEN SVC for more 
information). 


Entry Conditions 


A = 35 
(DE) = data control block of the currently open file 
BC = record number 
BC = @: position to beginning of file 
BC = X'FFFF': position to end of file 
HL = Reserved 
If you chose the E mode when you opened the file, then: 
BC = address of 3 bytes in RAM The format is: 
upper middle lower 
byte byte byte 


where 99 O00 @@ = first record of file 
and FF FF FF = end of ride (EOF ) 


Exit Conditions 
NZ = Error 
A = error code 
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DIRSET Function Code 59 
Directory Information 


Gets directory information on any open file. 
DIRSET sets up the 8-byte block of memory that is one of the 


entry parameters for the RDDIR SVC. After you open the 
file, you can: 


: Find out which drive contains the file (See the 
ROD. SVGt s 
Zs Set up the 8-byte block in user memory (BC) for 


RDDIR. This lets RDDIR get directory information 
about the open file. 


Entry Conditions 


A = 59 
DE = address of the open data control block 
BC = address of the 8-byte block of user memory 


Exit Conditions 
All registers return unchanged, except Register A. 
BC = address of the 8-byte block of user memory set 
for RDDIR call to get the directory information 
of the open data control block (pointed to by 


DE ) 
Z = No error 
NZ = I/O error 
A = error code 


Note: Be sure to load Register Pair DE with zero (LD DE,Q) 
after executing DIRSET and before executing RDDIR. If DE is 
non-zero, RDDIR expects a wildcard mask and, in most cases, 
cannot find a match. 
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specified position in an FLR 
to write the first record (Q) 
a VLR file. 


record into the record area 


pointed to by RECADR in the parameter list. Or, if the 
record length is 256 and the record type is fixed, put the 
record in the area pointed to by BUFADR (see the OPEN SVC 
for more information). 


Entry Conditions 


A = 44 
(DE) = data control block of the currently open file 
BC = record number 
BC = $: position to beginning of file 
BC = X'FFFF': position to end of file 
(HL) = Reserved 


If you chose the E mode when you opened the file, then: 


BC = address of 3 bytes in RAM The format is: 


First record of file 


where £0 O60 OP = 
= record after current EOF (EOF +1) 


and FF FF FF 


Exit Conditions 
NZ = Error 
A = error code 
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DISKID Function Code 15 
Read Disk ID 
Reads the diskette ID(s) from any or all of Drives §-7. 
This is useful when the program must ensure that the 
operator has inserted the proper diskette. 
TRSDOS-II places the diskette ID(s) in the buffer pointed to 
by Register Pair HL. If a drive is not ready, TRSDOS-II 
places blanks in the buffer. If you specify 255, TRSDOS-II 
reads the IDs from all drives. If you have do not have hard 
disks, the last 32 bytes of the buffer are blank. 
Entry Conditions 
A = 15 
B = drive select code 
B = 0-7: read from specified drive (§-7) 
| B = 255: read all disks' IDs 
(HL) = disk ID buffer 
If B = 9-7: 
| The buffer must be 8 bytes long. 
If B = 255: 
The buffer must be 64 bytes long. 
Exit Conditions 
(HL) = disk ID(s) 
| NZ = Error 
A = error code 
—_ 


Radie Shaek 


3753 


TRSDOS-II REFERENCE MANUAL 


TRS-80 ° 


DOSCMD Function Code 37 
Execute TRSDOS-II Command 


Passes a command string to TRSDOS-II Ready mode for 
execution. After the command is executed, control returns 
to TRSDOS-II. All open files are closed automatically. 


Entry Conditions 


A = 37 
(HL) = command string 
B = length of string 


Exit Conditions 
None 
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ERRMSG Function Code 52 
Error Message 


Returns an 8@-byte error description to the specified buffer 
area, in response to the specified error number. 


Entry Conditions 


A = 52 
B = error number | 
(HL) = 8@-byte buffer area above X'27FF' 


Exit Conditions 
NZ Error 
A error code 
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ERROR Function Code 39 
Display Error Number 
Displays the message ERROR, followed by the specified error 
code, at the current cursor position. 
Entry Conditions 
A = 39 
B = error number 
Exit Conditions 
NZ = Error 
A = error code 
WwW 
® 
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FILPTR Function Code 58 
Get Pointers of a Open File 


Gives information on an open user file. If it does not make 
a match, the SVC returns an error. 


Note: We recommend restricting your use of the FILPTR 
since this SVC is restricted to 96 files. If you are 
familiar with FILPTR, you should change your existing 
programs to use RDDIR instead. 


Entry Conditions 


A = 58 
(DE ) = data control block of the currently open 
file 


Exit Conditions 
Z flag = No error 


NZ = Error 
B = drive that contains the file (binary 9-7) 
C = position of the file in the diskette 
gdirectory (binary 1-96) 
Notes 


This SVC is intended for use with the RAMDIR SVC. After 
opening a file, you may: 


i Use FILPTR to find out which drive contains the 
file and which directory record contains the 
file's information. 


Zs Use RAMDIR to obtain information about that 
file (current file space allocated/used, 
protection level, and so on). 
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HLDKEY Function Code 29 
Enable the <HOLD> Key 


Suspends and restarts terminal output whenever you press 
<HOLD>. 


This SVC must first be enabled; call the SVC with B = 1. You 
must periodically call the SVC to see if the <HOLD> key has 
been pressed; call the SVC with B > 1. This places the 
program in control of the pause checking. If <HOLD> has 
been pressed, the program pauses until <HOLD> is pressed 
again. 


Returning to the TRSDOS-II READY command level turns off the 
<HOLD> processor. However, you can execute a command 
without turning off the <HOLD> processor. See the JP2DOS 
and DOSCMD SVCs for ways to execute a command. 


Some library commands and utilities, including DIR and LIST, 
reset the <HOLD> processor. 


No matter how many times you press <HOLD> before you call 
HLDKEY, TRSDOS-II interprets it as one keystroke, thus 
Starting the pause. 


Entry Conditions 


A = 29 
B = function code 


The HLDKEY function codes are: 


Contents 

of B Meaning 

) Turns off the <HOLD> processor. Pressing 
<HOLD> generates X'@@'. 

Le Turns on the <HOLD> processor. Pressing 
<HOLD> does not generate keyboard data. 
TRSDOS-II intercepts it. 

>1 Checks for the <HOLD> key. If you have 
pressed it, TRSDOS-II pauses until you press 
it again. 


Exit Conditions 
NZ = <HOLD> processor is off 
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INITIO Function Code @ 
Initialize I/O 


Initializes all input/output drivers. 


This SVC is already done by TRSDOS-II. You do not need to 
call it, except in extreme error conditions. 


Entry Conditions 


A = § 
Exit Conditions 
NZ Error 


A error code 
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JP2DOS Function Code 36 
Jump to TRSDOS-II 


Returns control to TRSDOS-II, after closing all open files 
and doing system housekeeping. 


Another way to do this is to execute an RST § instruction. 
There are no entry conditions for this method. 


Entry Conditions 
A = 36 


Exit Conditions 
None 
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KBCHAR Function Code 4 
| Keyboard Character 
Gets one character from the keyboard. If characters are 
present in the key-ahead buffer, the first character in the 
buffer is returned to Register B. 
The <BREAK> key is masked from you. It is never returned, 
Since it is intercepted by TRSDOS-II. If you enable a 
SETBRK routine, control passes to the processing program 
whenever <BREAK> is pressed (see the SETBRK SVC). 
Otherwise, control passes to TRSDOS-II READY. 
Entry Conditions 
A = 4 
Exit Conditions 
B = character found (if any) 
If no character is returned, B is unchanged. 
NZ = No character is present 
A = error code 
m» 
f \ ® 
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KBINIT Function Code l 
Keyboard Initialize 


Initializes the keyboard input driver. You might want to 
call KBINIT before starting keyboard input, to clear 
previous keystrokes and the key-ahead buffer. TRSDOS-II 
automatically does this at startup. 


Entry Conditions 
A = ] 


Exit Conditions 
NZ Error 
A error code 
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KBLINE Function Code 5 
Keyboard Line 


Inputs a line from the keyboard to a buffer and echoes the 
line to the display, starting at the current cursor 
position. As it receives and displays each character, 
KBLINE advances the cursor to the next position. 


When you enter KBLINE, the input buffer contains a string of 
periods, which it sends to the display. This string is for 
your convenience. It indicates the length of the input 
field. 


The keyboard line ends when you press <ENTER> or when the 
input buffer is filled. When you end the line input, KBLINE 
sends a carriage return and an "erase to end of screen" 
command to the display. It stores a carriage return as a 
character input only if you press <ENTER>. 


Entry Conditions 


A = 5 

(HL) = input buffer 

B = maximum number of characters to receive 
(1-255) 

Exit Conditions 

B = actual number of characters input (including 
carriage return) 

C = terminating character of input 
C = X'@M': input buffer is filled without a 


Carriage return 
C = X'@D': line ended with a carriage return 


If you type a control code not listed below, KBLINE places 
it in the buffer and represents it on the display with the 
+ symbol. 


Hex 
Key Code Function 
<BACKSPACE> £8 Backspaces the cursor and erases a 
character. 
<ENTER> gD Ends the line. Clears trailing periods 


on the display but not in the buffer. 
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Key Code Function 

<CTRL> <W> 17 Fills the remainder of the input buffer 
with blanks. Blanks the remainder of 
the display line. 

<CIRGS <x) 18 Fills the remainder of the input buffer 
with blanks. Blanks to the end of 
the display. 

<ESC> 1B Reinitializes the input function by 
filling the input buffer with periods 
and restoring the cursor to its original 
position. 

<left arrow> Lc Backspaces the cursor to allow editing 


of the line. Does not erase characters. 


<right arrow> 1D Advances the cursor to allow editing of 
the line. Does not erase characters. 
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KBPUT Function Code 39 
Put Character into Key-Ahead Buffer 


Puts one character into the keyboard key-ahead buffer, in 
the same manner that pressing that key on the keyboard does. 


The character is placed after any characters already in the 
buffer. 


If the character is X'@#@', TRSDOS-II puts it into the buffer 
if HLDKEY is off. If HLDKEY is on, X'@@' triggers hold 
processing. (See the HLDKEY SVC.) 


If the character is X'ff3', it invokes the <BREAK> key 
processing. (See the SETBRK SVC.) 


Entry Conditions 


A = 39 
B = character to be put into the buffer 


Exit Conditions 


Z = Character is put into the buffer 

NZ = Buffer is full; the character is not in the 
buffer 

A = error code 
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Delete File From Directory 


Deletes the specified file from the directory. You must 
close a file before you can KILL it. 


Entry Conditions 

A 2 

(DE) = data control block 
Exit Conditions 


NZ = Error 
A = error code 
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LOCATE Function Code 33 
Locate Record 
Returns the number of the current record (the last record 
accessed). You can use LOCATE only with FLR files. 
Entry Conditions 
A = 33 
(DE) = data control block of the currently open file 
HL = Reserved 
Exit Conditions 
BC = current record number 
NZ = Error 
A = error code 
If you chose the E mode when you opened the file, then: 
BC = address of 3 bytes in RAM where the record 
number is to be stored, in the following 
format: 
upper middle | lower | 
byte byte byte 
—_ +> it Rs cc 
where @@ @0 @@ = first record of file 
f ‘ ® 
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LOOKUP Function Code 28 
Look Up in a Table 


Does a lookup function on a table of 3-byte entries. Each 
entry looks like this: 


Byte l Byte 2 | Byte 3 


At the end of the table, you must place a l-byte X'FF'. 
Since X'FF' is the table terminator, your search keys must 
be between X'@M' and X'FE'. 


Given a l-byte search argument, LOOKUP locates the first 
matching entry in the table. It uses a sequential search 
algorithm. 


If the table contains search keys followed by addresses, 
then (upon return from the routine with the Z flag set) you 
can JP (HL) to transfer control to the desired address. 


Entry Conditions 


A = 28 
(HL) = byte 1 of the table 
B = search argument 


Exit Conditions 
NZ Search argument is not found 
HL data 
H contains byte 3 
L contains byte 2 
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MPYDIV Function Code 23 
Multiply Divide 
Multiplies or divides with one 2-byte value and one l-byte 
value. 
Entry Conditions 
A = 23 
B = function switch 
If B = #: multiply 
HL = multiplicand 
Cc = multiplier 
If B # @: divide 
HL = dividend 
& = divisor 
Exit Conditions 
If B = @: 
HL = product (Hi * €) 
C flag = Overflow occurred 
A = overflow byte 
aa Z = Product is @ 
If B # @: 
HL = quotient (HL/C) 
Se = remainder 
C flag = Dividing by @; division is not attempted 
Z = Quotient is @ 
f \ ® 
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OPEN Function Code 49 
Open File 


Creates new files and opens existing files. 
A given file can be open under only one data control block 
(DCB) at a time. Because of the versatile file processing 


routines, this one DCB is enough to handle the various I/O 
applications. : 


Entry Conditions 


A = 49 
(DE) = data control block 
(HL) = parameter list 


Exit Conditions 
NZ Error 
A error code 


Before calling OPEN, you must reserve space for the data 
control block, parameter list, buffer area, and record area. 


Data Control Block (68 bytes) 


The data control block (DCB) is used by TRSDOS-II for file 
access bookkeeping. Use it specify the filespec when 
opening a file. 


Before calling OPEN, place the filespec at the beginning of 
the DCB, followed by a carriage return. (See "File 
Specification" in the "Introduction.") 


For example: 


Contents of First Bytes of DCB Before Open 
($ signifies a carriage return) 


While a file is open, TRSDOS-II replaces the filespec with 
information TRSDOS-II uses for bookkeeping. When you close 
the file, TRSDOS-II returns the original filespec (except 
the password) to the DCB. 
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Never modify any part of the DCB while the file is open. 
The results are unpredictable. 
Parameter List (ll bytes) 


Contents of Parameter List (sample) 


BUFADR RECADR EODAD Access RL File User 
Type Type Attribute 
Creation 
Code 


BUFADR (Buffer Address) 


Two-byte field that points to the beginning of the buffer 
area. 


The buffer area is the space TRSDOS-II uses to process all 

file accesses. When spanned records are required, you must 
reserve 512 bytes. When spanning is not required, reserve 

only 256 bytes. 


With FLR files, spanning is required only when the record 
length is not an even divisor of 256. For example, if the 
record length is 64, then each physical record contains four 
records, and no spanning is required. In this case, reserve 
only 256 bytes for processing. 


However, if the record length is 24 (not an even divisor of 
256), then some records must be spanned. In this case, 
reserve 512 bytes. 

With VLR files, you must reserve 512 bytes for processing. 


Spanning may be required, depending on the lengths of the 
records. 


RECADR (Record Address ) 


Two-byte field that points to the beginning of the record 
area. 
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This is where TRSDOS-II places the record after a disk read 
and where you would put the record to be written to disk. 


For FLR files with a record length of 256, RECADR is not 
used. Your record is in the buffer area pointed to by 
BUFADR. 


If you have an FLR file with a record length not equal to 
256, make this buffer the same length as the record. 


If you have VLR files, be sure to make the buffer long 
enough to contain the longest record in the file (including 
the length byte). If you are not sure of the length, 
reserve 256 bytes. 


EODAD (End of Data Address) 

Two-byte field which can be used to give TRSDOS-II a 
transfer address to use in case TRSDOS-II reaches the EOF 
during an attempted read. 

Control transfers to the EODAD if this happens. If EODAD = 
@ and the EOF is reached, the SVC returns with the EOF error 
code in Register A. 


Access Type 


Specifies the type of access you desire. It can be any of 
the following: 


ASCII 
Character Meaning 
R Read only 
Ww Read/Write (data files) 
P Read/Write access to Z8% program files 


If OPEN finds a program file, TRSDOS-II returns a P in the 
read/write field in the parameter list. For example, a call 
to OPEN with a parameter list of: 


DP7H PH7H G858 R BY F BP PP 
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returns the following, if the file found is a program file: 


PP7H OBO7H G858 P BM F PO PP 


RL (Record Length) 
One-byte field that specifies the record length to be used. 


Zero indicates a record length of 256. For VLR files, ignore 
this field. If the file exists, and the creation code is Q, 
TRSDOS-II supplies the correct RL value, regardless of what 

is stored there. 


File Type 


One-byte field that contains an ASCII "F," "V," or "E" (for 
"fixed-length," "variable-length," or "extended mode"). 


Once a file exists, this attribute cannot be changed. If 
the file exists, and the creation code is §%, TRSDOS-II 
supplies the correct F, V or E value. 


If you specify E, then DIRRD, DIRWR and LOCATE use a 24-bit, 
indirect, 3-byte number. The E specifies FLR records and an 
extended mode of specifying record numbers. The directory 
shows F, even though you specify the E mode. 


Creation Code 


One-byte field that contains a binary number "9," "1," or 
i 
Code Meaning 
g Opens the existing file, but does not reset the 


record length and EOF. 


1 Creates a new file. Returns an error if a file of 
the same name already exists on the specified 
drive. Sets the record length and EOF at OPEN. 
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Code Meaning 
2 Opens a file, overwriting any existing file of the 
same name. Otherwise, it creates a new file. 
Resets the record length and EOF. 


User Attribute 


Lets you give your own ID number to certain types of data 
files. You can use any number from 32-255. 


TRSDOS-II does not examine this user attribute. It is 
solely for your convenience. 


You can assign this user attribute only to files you open 
with a creation code of 1 or 2. Files opened with a 
creation code of @ retain the file's previously assigned 
user attribute. Any file created with the CREATE command 
has a user attribute value of @. 
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PARSER Function Code 46 
Analyze Text Buffer 


Analyzes or "parses" a text buffer into fields and 
subfields. 


PARSER is a convenient and powerful SVC. It is useful for 
analyzing TRSDOS-II command lines, including keyword 
commands, file specifications, keyword options and 
parameters. You can use it also as a fundamental routine 
for a compiler or text editor. 


Entry Conditions 
A = 46 
(HL) text buffer 


(DE ) list address block 
DE = @: no lists are to be used 
C = maximum length of the parse 


Exit Conditions 


(HL) = field position 
If a delimited field was found: 


(HL) = first byte of the field 
>, If no field was found: 


(HL) = terminator or non-blank separator 


If the parse reached the maximum length: 


(HL) = last byte of the buffer 


B = actual length of the field (excluding leading 
and trailing blanks) 
A = character preceding the field just found 


If B= 9, A= X'FF'. 


c = number of bytes remaining to parse after the 
terminator or separator (trailing blanks have 


been parsed). 

D = separator or terminator at the end of the 
field 
If D = X'FF', then the parse stopped without 
finding a non-blank separator or terminator. 


E = displacement pointer for the next parse call 


Add the displacement pointer (E) to the field position 
(HL) to get: 

a) Beginning address of the next field, or 

b) Address of the byte following the last byte parsed 


If the parse reached the maximum length: 
E + HL = address following the end of the text buffer 
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If the parse did not reach the maximum length, and E = l: 
E + HL = address following the separator or terminator 


If the parse did not reach the maximum length: 


Z flag = Parse ended with a separator 

NZ = Parse ended with a terminator 

C flag = There were trailing blanks between the end 
of the field and the next non-blank separator 
or terminator 

NC = There were no trailing blanks 


PARSER is designed to allow repetitive calls for processing 
a text buffer. On exit from the parse, parameters for the 
next call are all readily available in the appropriate 
registers. 


Field 


A field is any string of alphanumeric characters 
(A-Z, a-z, 0-9) with no embedded blanks, delimited by 
separators and terminators. 


Separators and Terminators 
Separators and terminators are used to delimit (or separate) 
fields within a text buffer. PARSER has pre-defined sets of 
field-characters and separators... You either can use these 
or re-define them to suit your application. 
For example, the line: 

BAUD=399,PARITY=EVEN WORD=7 
contains 6 fields: BAUD, 39%, PARITY, EVEN, WORD, and 7. 
A separator is any non-alphanumeric character. PARSER stops 
when it encounters a separator, except when the separator is 
a blank (X'2@'). PARSER ignores leading and trailing 
blanks. After the trailing blanks, the parse stops at the 


beginning of the next field or at the first non-blank 
separator. 
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You can also define terminators, which stop PARSER 
regardless of whether it has found a field. Unless you 
specifically define these terminators, the parse stops only 
on non-blank separators. 


Separators and terminators have the same effect on a parse. 
The only difference is in how they affect the F (Flag) 
register on exit. 


A field can be delimited by paired quotation marks, also: 
"field" or 'field' 


When you use quotation marks, all characters (not just 
alphanumerics) are taken as part of the field. The 
quotation marks are not included in the field. For example: 


"DATE (97/11/79) ' 


is interpreted as one field that contains everthing inside 
the quotation marks. 


When you use a quotation mark to mark the start of a field, 
“™ you must use the same kind to end the field. This lets you 
t 7 use quotation marks within a field. For example: 


ny FFOG' " 


is parsed as one field that contains everything inside the 
double quotes, including the single quotes. 


To Re-define the Field, Separator, and Terminator Sets 


If you need to change the field and separator sets, or 
define terminators, you can provide three change-lists via 
a list address block. 


List Address Block 


The list address block is six bytes long and contains 
three 2-byte addresses (LSB,MSB), one for each change-list: 
List l: characters to be used as terminators 
List 2: additions to the set of field characters 
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List 3: deletions from the set of field characters 
(alphanumerics to be interpreted as 
separators) 


Each list has the following form: 


nis the 
number of 
characters in first second nth 
list character character character 
Notes 
‘ There are three ways to indicate a null list: 
a) Set the character-count byte (n) equal to 
zero. 
b) Set the pointer in the list address block to 
zero. 
c) Set DE equal to zero, if you aren't going to 
provide any lists. 
‘ Characters are stored in lists in ASCII form. 
‘ If a character appears in more than one list, it 


has the characteristics of the first list that 
contains it. 
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Here is a typical list address block with its associated 
lists. Assume that on entry to PARSER, DE = X'8@@G'. 


X’8000’ 3 X’9000 


Start Start Start 4 carriage a anys 
of of of characters return ) 
list1 list2 list3 in list 1 


X’9010' x’9020 


3 null 
characters ‘?” “@” “#” list 
in list 2 
® 
Radie Shaek 


3/79 


TRSDOS-II REFERENCE MANUAL 


TRS-8O0 °* 


Sample Programming 


The following code shows typical repetitive uses of PARSER 
to break up a parameter list. 


. secs Saas teste asenp Wout ned saues|iesbsd: Sense eons gratk enced <eabs f? RR E. fF Fay Fe F fF {} Re fF? £4 4 a J hs] (-; L.. {} {} F? Seed Ss ce Sebo Gece 60a cua laasoe Gove <Lebiy Chad's ehei neni dade cod cheeks nade Nipess awed ats Ceaeet See 8 
LD Cy MAXLEN 5 ¢C = Maximum length ta parse 

10 Es s For initial call to NXTFLOI 
1D Hlos BUFFER s (HL) = string toa Parse 
ova dy Saad cokes Gaal: Sonas Stand Baesds seep Sao F? A R a F L. {)} 7.) F? assis Sicha esd i nsec ona Sabca Sais. Grae Sebi ata uscd OOO SN GOCE nat Chala Sesily opal Sane sia sce ites secshscace ated neue oneon/aneew GHIel waspsiaaane 
PARSE CALL NX TRLD 

CALL. HANDLER 

JR NZsNXTRTN 


— 


> Routine ta call PARSER 
s Routine te handle new field 
© Go te next roautine af 
4 Parsed ended an terminatear 
1D Aa tl 5 Else Get mew max length 
OR ray s Is it zera? 
JR NZs PARSE 3 
LD As GF FH 5 
Oo 1) 3 


Tf mots then cantinue 


Tf D=@F FH then mo sePparatar 
5 at end af buffer. 
JR Z3kERR 5 So Go to @rrar routine 
JR NX TRTN 5 Elses then do next routine. 
Bsns seen tee seen ane eee aves vat enn nun nee cues ete f- I f= b D eas KH A N} D L.. I Ni iy fy {) I } ei [ NE Sess ‘adic sass asaa adage adose abs <cwth GaseksSese caace: Saka Sau! oka Sabicea sacs ‘Coa Sntgh Sacer S08a sees eaean aA 
HANDLR PUSH Ay s Must save status registers 
s and any ather reGisters 
5 Will be changed. 
5 Processing code Goes here... 
POP A\F s Restore AF Cand ather 
s registers saved at entrv) 
RET 
Sans es ns nn te a wee Nf TB RREE EE Pm mn me ne ee eee ete ea a i ie ttt me 
NXTFLD LD Ds @ 5 “#era mek af DE 
ADD HL. s DE > (HL) = where to start Parse 
LD Des Lak 5 (DE) = List address tloack 
>; If DE=@ then mo lists used, 
1D a 4 ss Function Code 
RST & 
RET 
Bet me eee sees ents arent mtn ents aren une eens ater tne Ff Fe {) C Fe ray I c. () If 7 J hy IE: Cy bE: RR FE sss is SaaS sand ath fap cer wea sss eae bes aba jeu ca ee, Soar oe ovie5) eect saat E Sacee aches pate Seapets 
NXTRTN EU $ 


Radie Shaek 


3/89 


TRSDOS-II REFERENCE MANUAL 


TRS-80 ° 


PRCHAR Function Code 18 
Print Character 


sends one character to the printer. 


Note: Most printers do not print until their buffer is 
filled or they receive a carriage return. (See your 
printer's manual for information. ) 


Normally, TRSDOS-II intercepts certain codes and does not 
send them directly to the printer. There are several ways 
to override some or all of these character translations. 
(See the PRINIT and PRCTRL SVCs.) 


While the serial printer option is selected, allowing 
printer output to Channel B, TRSDOS-II recognizes two 
Characters from Channel B. These affect all serial printer 
output operations: 


ASCII Hex 

Name Code Result 

DC3, <CTRL> <S> 13 Pauses printing 
DCL, <CTRi> <O> ri Resumes printing 


Entry Conditions 


A = 18 
B = ASCII code for the character to send 


Exit Conditions 


NZ = Error 
A = error code 
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ASCII Hex 

Name Code 
Tab g9 


Vertical Tab QB 


Form Feed gc 
Carriage gD 
Special 8D 
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INTERCEPTED CODES 


Result to Printer 


Sends one to eight spaces to provide 
the tab function. 


Same as form feed below. 


Sends enough carriage returns 
or line feeds to advance the paper to 
the next "top of form." 


Interpreted as a line feed when the 
current line is empty (no characters are 
printed since the last carriage return 
or line feed). This interpretation 
enables the correct operation of Radio 
Shack printers. In the auto line-feed 
mode, X'@A' is sent after every X'QD'. 


Sends a carriage return to the 
printer. In the auto line-feed mode, 
using this code lets you senda 
carriage return without a line feed. 
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PRCTRL Function Code 95 
Control Printer Operations 


Gives you various printer options and lets you check the 
status of printer-related functions. 


If you use SPOOL's capture function, TRSDOS-II sends the 
captured data directly to the capture file -- regardless of 
which control settings you select. If you use SPOOL'S print 
function, TRSDOS-II intercepts the printed data to the 
selected control settings. (See the SPOOL command for 
details.) 


By switching between the serial and parallel output modes, 
you can operate with two printers. One printer can use the 
automatic control features of TRSDOS-II, such as the auto 
form feed, while the other printer is controlled by the 
program. This is necessary because only one set of control 
counters is maintained. 


Entry Conditions 


A = 95 

c = option value (used with option codes 3 
and 4) 

B = option code 


Exit Conditions 

Z flag No error 

NZ Error 
physical page length 
logical page length 
logical line length 


printer option 
E = P: parallel printer 


E= S: serial printer 
number of characters printed on the present 
line 


L = number of lines printed on the present page 


(See the PRINIT SVC for details on physical and logical page 
length and logical line length.) 


HoOw 
| | | | 


a 
Il 
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Code Option 
4) Gets printer status only (see "Exit Conditions") 
i Selects the serial printer driver (you must 


initialize Channel B first) 


2 Selects the parallel printer driver 

3 Resets the current line count to the value 
contained in Register C 

4 Resets the current character count on current line 


to the value contained in Register C 

5 Begins the transparent mode 

6 Ends the transparent mode 

f Begins the dummy mode 

8 Ends the dummy mode 

9 Begins the auto line-feed (after carriage return) 
mode 

1g Ends the auto line-feed (after carriage return) 
mode 


Explanation of Options 


Serial/Parallel Printer Option 


While the serial printer option is selected, allowing 
printer output to Channel B, TRSDOS-II recognizes two input 
characters from Channel B. These affect all serial printer 
output operations: 


ASCII Hex 

Name Code Result 

DC3, <CTRL> <S> B ae Pauses printing 
DC1l, <CTRL> <Q> cm Resumes printing 


Line Count/Character Count 
TRSDOS-II maintains a single line counter and a single 
character counter. It updates these for either serial or 


parallel printing. TRSDOS-II does not maintain separate 
counters for serial and parallel printing. 
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Transparent Mode 


The transparent mode overrides all data translation. All 
data bytes go directly to the printer. TRSDOS-II does not 
examine the contents or update the line and character 
counts. 


Normally, TRSDOS-II "intercepts" certain control characters 
and interprets them. In this way, TRSDOS-II provides 
printer-related features which may not be available from the 
printer. 


For example, tabs (X'§9') are intercepted so that TRSDOS-II 
can send the appropriate number of spaces to provide the tab 
function. Form feeds (X'@C' or X'#B') are intercepted so 
that TRSDOS-II can advance the paper to the next top 

CL. TOrM:. 


Special settings of the printer initialization values can 
override individual code translation. (See the PRINIT SVC 
for details.) 


Dummy Output Mode 


The dummy mode "throws away" all printer output and returns 
with a "good" (Z flag set) return code. During dummy mode 
operation, the line and character counts remain unchanged. 


Auto Line Feed 


Normally, the TRSDOS-II printer driver does not output 
line feeds after carriage returns, because most Radio 
Shack printers do an automatic line feed after every 
Carriage return. 


If your printer does not do automatic line feeds after 
carriage returns, you may enable the TRSDOS-II auto 
line-feed function. 


While the function is enabled, TRSDOS-II outputs a line feed 
after each carriage return. This is true in all modes 
including the transparent mode. 
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Note: In the auto line-feed mode, you may send a carriage 


return with no line feed by outputting the code X'8D'. If 
the printer is capable of overprinting, this code returns 
the carriage without advancing the paper. 


Precedence of Options 


The priority of the available options is (in descending 
order): 


SPOOL capture mode (See the SPOOL command) 
Dummy mode 

Auto line-feed (after carriage return) mode 
Transparent mode 

Normal mode 
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PRINIT Function Code 17 
Printer Initialization 


Initializes the printer driver. 


It does not advance the printer paper and does not check 
the printer status or availability. It operates even if the 
printer is off-line. 


Entry Conditions 

17 

physical page length 
logical page length 
logical line length 


Exit Conditions 
NZ = Error 


0W PY 


The physical page length is the number of lines that can 
be printed on one page. It is normally 66. 


The logical page length is the number of lines you want 
printed on each page. It must be less than or equal to 
physical page length. After that number of lines is 
printed, TRSDOS-II sends a top-of-page request to the 
printer (form feed). 


The logical line length is the maximum number of 

characters to be printed on each line. Once that number is 
reached, the line is printed and a new line is begun 
(wrap-around). 


Notes 


P If the logical page length = the physical page 
length and both are non-zero, TRSDOS-II does not do 


an end-of-page skip. It translates form feeds into the 
number of line feeds necessary to get to the top of the 
next page. 


‘ If the logical page length or the physicial page 
length is zero, the other also must be zero. In this 


case, TRSDOS-II does not translate form feeds (X'§C') 
and vertical tabs (X'@B') into line feeds, but sends 
them directly to the printer. 
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‘ If the logical line length is zero, then TRSDOS-II 
does not translate tab characters (X'9#9') into spaces, 
but sends them directly to the printer. TRSDOS-II 
maintains an internal character count, with tabs 
counting as one character. 


‘ On exit, TRSDOS-II automatically resets the current 
line and character counts to zero. 


° TRSDOS-II assumes the printer is at the top of the form 
when you execute PRINIT. 

. TRSDOS-II resets the dummy and transparent modes to the 
normal mode. Auto line feed and DUAL are unaffected by 
PRINIT. 

‘ When you power up or reset TRSDOS-II, it assumes the 


following defaults: 


Parameter (PRINIT register) Value 


physical page length (B) = 
logical page length (C) = 69 
logical line length (D) = 


The other options set during initialization are: 


Auto line-feed mode = off 
Dummy mode = off 
Transparent mode = off 
Parallel printer == on 
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PRLINE Function Code 19 
Print Line 


Sends a line of characters to the printer's buffer. The 
line can include control characters as well as printable 
data. 

see the PRCHAR SVC for a list of intercepted codes. 


Entry Conditions 


A = 19 

(HL) = start of the buffer containing data and 
controls to send to the printer 

B = line length (the number of characters to send) 

Cc = control character (any character) to send 


after the last character in the buffer 


Exit Conditions 
NZ Error 
A error code 
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RAMDIR Function Code 53 
Get Disk Directory/Free Space into RAM) 


Lets you examine a disk directory entry or the first 96 
files in the directory, or it lets you determine the 
diskette's free space. The information is written into a 
RAM buffer. 


Only non-system files are included in the RAM directory. 


Note: We recommend restricting your use of the RAMDIR 
since this SVC is restricted to 96 files. If you are 
familiar with RAMDIR, you should change your existing 
programs to use RDDIR instead. 


Entry Conditions 


A = 53 
B = drive number (binary 9-7) 
‘& = function switch 


Contents of C Result 


g Gets the entire directory into RAM in 
the format described below. 

1-96 Gets one specified directory record 
(if it exists) into RAM in the format 
described below. 

295 Gets free-space information in the 
format described below. 


(HL) = buffer area 


If C = £, compute the buffer size by this formula: 
Number of bytes required = 34 * (# of non-system files + 1) 


Because RAMDIR can read no more than 96 non-system 
files, the largest possible directory needs a buffer 
size of 3265 bytes. 


fr < 1-96, the buffer must be 34 bytes long. 
it ¢ 255 (free-space info desired), the buffer must be 4 
bytes long. 


Exit Conditions 


Z flag = No error; (HL) = directory or free-space 
information 
NZ = Error (Register A contains the TRSDOS-II 


error code) 
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The directory is given in "records," one per file. Each 
record has the following form: 


Byte 
Number 


Contents 


Comments 


ASCII colon marks beginning of 
each directory record in RAM. 


filename/ 
ext:d <ENTER> 


<ENTER> represents a carriage 
return. Trailing blanks are 
added as needed to fill 15 bytes. 


re or eNy | | 


Indicates fixed- or variable-length 
records. 


Logical record length l1-byte 
binary @-255. § implies LRL =256 
or VLR file. 


# of sectors 
allocated 


Binary §@-65535 in LSB-MSB sequence; 
null files = OQ. 


# of sectors 
in storage of 
data 


Binary §-65535 in LSB-MSB sequence; 
null files = Q@Q@. 


EOF byte 
(position 

of the first 
byte of the 
last record 
written) 


Binary 9-255; @ implies the first 
byte in the last sector. 


# of records 
written 


Binary @-65535 in LSB-MSB sequence; 
null files = Q99@. 


User 
attribute 
byte 
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Byte 
Number Contents Comments 
28 Protection Binary §-7. 

level 
29-31 Date created Binary year, month, day. 
32734 Date last Binary year, month, day. 

updated 


ES SEES ED ED SE REE SEED HOTNESS “SETS SE EES STEED SOD ED ED OED SED RES EEE CED GSE SSEED ED GEES CUE CURED COSED SENED SURED CEGED GOGED CORED CREED SEED COED GED CEGED ED SEED CURED SSE SED SERED CUEED GEE se GEE SSD GR ED ED soe Coe coe oe 
Ee A ENED TD SEN ED OT OOD ED SD SEE SEED ETD REED SOEUR GED ED SURED GREED GED GREED SRE SORE OUD ED CUED SE ED RD EE SD SD GED SRE GEUED CUED SED SUED CD UD ED CE SEED SS ED STEED SEED CED COED GEE GEES CRED OED cue Ee ee oD oe oe oe 


When an entire directory is given (C = # on entry), a number 
sign (#), instead of the expected colon (:), marks the end 
of the directory. When C = from 1 to 96, the record always 
ends after the 34th byte, without a trailing number sign. 


Free-Space List Format 


Byte 

Number Contents Comments 

1-2 # of free granules *Binary LSB-MSB sequence 
3-4 # of extents Binary in LSB-MSB sequence 


* The number of sectors equals the number of granules 
multiplied by 5. 
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RANDOM Function Code 29 
Random 1-Byte Value Return 


This routine returns a random l-byte value. 


TRSDOS-II uses the time/date values in computing the random 
number. This method lessens the possibility of repetition. 


Pass the routine a limit value. If the limit value is 
greater than 1, the value returned is in the range [§,(limit 
- 1)]. For example, if the limit is 255, TRSDOS-II returns 
a value in the range [§,254]. If the limit value is 8 or l, 
the value returned is @Q@. 


Entry Conditions 
A 26 
B limit value 


Exit Conditions 
© = random number 
NZ = Error 
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RDDIR Function Code 32 
Reads in Directory Record 


Reads in one directory record from one drive at a time. It 
also lets you use a wildcard mask. TRSDOS-II puts the 
directory record into a 128-byte ASCII string in user 
memory. 


To read the directory of a specific file, use the filespec 
as the wildcard mask. (Do not use the asterisk.) RDDIR 
then searches for the file. 


(See the DIRSET SVC for details on open file directory 
information. ) 


Entry Conditions 
A = 32 
BC = address of the 8-byte block in user memory 


defined as: 


| binary | directory index* | ** 
| drive # | FF FF FF FF FF FF | £66 
* = FF FF FF FF FF FF sets the index to the beginning 


of the directory 


** = end-of-list terminator 
DE = wildcard mask For example: 
MASK DEFM '*/BAS' 
DEFB O@DH ;must end with 
<ENTER> 


If DE = @, no wildcard selection takes place. 


HL = address of the 128-byte area where data is to 
be placed 
Exit Conditions 
HL = address of the 128-byte area where data is 
placed. It is in the TRSDOS-II DIR format. 
Z No error 
Error; EOF encountered 


I/O error 
error code 


'@) 

Z, 

NS 
| | 
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LOOP 


END: 


CTLBLK: 


MASK : 


TRS-8O ° 


Offset Table for HL Buffer 
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Description # Bytes 
Length byte 1 
Filename i 
File-left-open marker i. 
Date created 8 
Date updated 8 
ACtrib 4 
File type a: 
Record length 4 
Number of records 9 
Sectors allocated 7 
Sectors used 7 
Reserved 48 

LD BC, CTLBLK 

LD DE , MASK 

LD HL, IMAGE 

LD A,32 

RST 8 

JR NZ, END * END OR ERROR HAS OCCURRED 

(display “IMAGE") 

JR LOOP 

JR CC eOF : INDICATES EOF 

(exit routine; otherwise, an error occurred) 

DEFB i ; DRIVE # 

DEFB -l1,-l1,-l : BEGINNING OF DIRECTORY 

INDEX 

DEFB -l1,-1,-l . 

DEF'B g * END OF LIST TERMINATOR 

DEFM '*/BAS' : FIND /BAS FILES ONLY 

DEFB @DH : CR 

DEFS 128 * AREA TO STORE DIR RECORD 


IMAGE: 
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READNX Function Code 34 
Read Next Record 


Reads the record following the current record (the last 
record accessed). If you just opened the file, READNX reads 
the first record. 


Upon return, your record is in the record area pointed to by 
RECADR in the parameter list. Or, if the record length is 
256 and the record type is fixed, your record is in the area 
pointed to by BUFADR. 


Entry Conditions 


A = 34 

(DE) = data control block for the currently open file 

HL = Reserved for use in later versions of TRSDOS-II 
Exit Conditions 

NZ = Error 

A = error code 
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RENAME Function Code 47 
Rename a File 


Changes the name and/or extension of a file. You cannot 
change the password. 


Both filespecs (old and new) must be terminated by a 
Carriage return. 


If the old filespec is password protected, you must 
include the password. Do not include a password in the 
new filespec; TRSDOS-II retains the old password. 


Entry Conditions 


A = 47 
(HL) = old filespec 
(DE) = new filespec 


Exit Conditions 
NZ Error 
A error code 
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Return after Command 


Sends TRSDOS-II an operator command. After the command is 
completed, your program regains control. 


Take care that TRSDOS-II doesn't overlay your program when 
it loads the command file you choose. Most TRSDOS-II 
library commands use memory below X'27FF'. A few go up to, 
but do not include, X'2FFF'. Single-drive copies use all 
user memory. 


Entry Conditions 


(HL) = command string 
B = length of string 
A = 38 
Exit Conditions 
NZ = Error 
A = error code 
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i 
REWIND Function Code 48 
Rewind Disk File 
Rewinds a disk file. After this SVC is executed, the next 
read/write accesses the first record of that file. 
Entry Conditions 
A = 48 
DE = data control block for the currently open file 
Exit Conditions 
NZ = Error 
A = error code 
® 
Radie Shaek 
3/99 


ea a ee a 


TRSDOS-II REFERENCE MANUAL 


TRS-8O ° 


RS232C Function Code 55 
Initialize RS-232C Channel 


Sets up or disables either Serial Channel A or B. Before 
you use it, be sure the correct channel is connected to the 
modem or other requirements. 


This routine sets the standard RS-232C parameters and 
defines a set of supervisor calls for I/O to the channel you 
choose. When you initialize Channel A, TRSDOS-II defines 
the following SVCs: ARCV, ATX, and ACTRL. When you 
initialize Channel B, TRSDOS-II defines BCRV, BTX, and 
BCTRL. 


Before re-initializing a channel, always turn it off. You 
may not turn off Channel A when HOST is active. 


Entry Conditions 


A = 55 
(HL) = parameter list 
B = function switch 


B = @: turn off channel 
B ~£ @: turn on channnel 


Exit Conditions 
NZ Error 
A error code 


Parameter List 


This 6-byte list includes the required RS-232C parameters: 


—e 8 oe 6a ee ee ee eee ee ee ep ee ee ee ee ee ee ee ee ee) ee ee ee ee eo ee oe eee ce ae oes oop 


Channel Baud Word Parity Stop End-of-List 
Rate Length Bits Marker 
Channel -- is an ASCII "A" for Channel A or "B" for 


Channel B. 
Baud Rate --is a binary value from "1" to" 8": 
1 for 119 baud 


2 for 159 baud 
3 for 398 baud 
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for 609 baud 

for 1209 baud 
for 2499 baud 
for 4899 baud 
for 9698 baud 


OnHN UI & 


Word Length -- is a binary value from "5" to "8": 


5 for 55-bit words 
6 for 6-bit words 
7 for 7-bit words 
8 for 8-bit words 


Parity -- is an ASCII "E," "0," or "N" (for "even," "odd," 
or "none"). 

Stop bits -- is a binary "1" or "2" for the number of stop 
bits. 

End list marker -- is X'@@' for the 16-character default 


buffer or X'@l' for a larger buffer. 


If you specify a larger buffer, the next five bytes specify 
the receive buffer, as shown below: 


Byte 9g End-of-list marker (X'#1') 
Bytes 1-2 Buffer start address (LSB/MSB) 
Bytes 3-4 Buffer end address (LSB/MSB) 
Byte 5 Terminator (X'@9') 


The buffer must be at least 49 bytes long, and the entire 
buffer (both front and back) must reside below X'8##G'. 


To determine the size of the buffer, use the following 
formula: 


number of characters * 2 + 15 = buffer size 


The number of characters to be stored must be at least 17. 
Remember, it must be small enough to fit below X'89PP'. 
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SCROLL Function Code 27 
Protect from Scrolling 


Lets you protect part of the display from scrolling. From 9 
to 22 lines at the top of the display can be protected. 

When scrolling occurs, only lines below the protected area 
are changed. 


Entry Conditions 


A = 27 
B = number of lines to protect (in range 
LB, 221) 
Exit Conditions 
NZ = Error 
A = error code 
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SETBRK Function Code 3 
Enable and Disable <BREAK> Key 


Lets you enable the <BREAK> key by defining a <BREAK> key 
processing program. Whenever you press the <BREAK> key, 
your processing program takes over. 


On entry to the <BREAK> processing program, the return 
address of the interrupted routine is on top of the stack. 
You can return to it with a Z-8@ return instruction (RET). 


All Z-8@ register contents are unchanged upon entry to the 
<BREAK> program. 


SETBRK also lets you disable the <BREAK> key, by removing 
the address of the processing program. You cannot change 
processing programs while the <BREAK> key is enabled. 


You must disable the <BREAK> function (HL=§) before setting 
HL to a new address. 


The <BREAK> key processing program must reside above 
A 2IEE « 


See "Handling Programmed Interrupts" for programming 
information. 


Entry Conditions 
A = 3 
HL = address of the <BREAK> key processing program 
HL = 0: disable the <BREAK> function 


Exit Conditions 
NZ Error 
A error code 


If HL = 8, then: 


(HL) = address of the deleted <BREAK> key processing 
program 
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SETUSR Function Code 2 
Set User 


Sets or removes a user vector, thus giving you the ability 
to add SVC functions. Function codes 96-191 are available 
for you to define, unless the serial interface is on (See 
the RS232C SVC). Function codes 192-127 are always 
available for you to define. 


Once you add an SVC function, you can call it via the RST 8 
instruction, just as you can the TRSDOS-II's SVC routines. 


Your routine must reside above X'27FF', and it should end 
with a RET instruction. 


To change an already defined function, you must first remove 
the old vector. 


You can call a non-recursive SVC (system or user-defined) 
from within a user-defined SVC. For example, do not call 
SVC 1907 from within SVC 197. 


Entry Conditions 

2 

function code(95 < code < 128) 
set/reset code 

C = @: remove the vector 

C # @: add the vector 


A 
B 
a 


If C = @ (remove vector): 
HL = entry address of your routine 


Exit Conditions 
If C = @ (remove vector): 
HL = removed vector address 
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SORT Function Code 56 
RAM Sort 


Sorts a list of entries in RAM. All entries must have the 
same length, from 1 to 255 bytes. The sort is done 
according to a user-defined sort-key, which you may locate 
anywhere in the entry. 


Entries with duplicate sort-keys remain in the same 
relative order. 


The routine uses a "bubble-sort" algorithm. 


Entry Conditions 
A 56 


(IX) first byte of the first entry 

(DE ) first byte of the last entry 

B position key within an entry 

(Zero equals the first byte of an entry.) 
length of each entry (C > Q@) 

sort switch 

HL = @: use ascending sort 

HL # @: use descending sort 


length of sort-key (L > @) 


In general, B + L must be less than or equal to C. 


c 
H 


L 


Exit Conditions 


NZ = Error 
A = special error return code (not the standard 
TRSDOS-II code) 
Value inA Meaning 


Gees DEED ENED OE GEE GEEED OEE GOURD GUEED GOEED GEES ERED SURED GED deme GEE tS GED CESS GREED SD GREP cE GEE ee GE a Se DG ES GEE eS GE Gee GE ae oe Gee aa aS au Ger au GSE ae Se see Gu ce eae Gas aor cup =D cue oe oo 


iL Key end exceeds the last byte of the entry 

y. Key start exceeds the last byte of the entry 

3 Entry length = @ (invalid) 

4 Key length = @ (invalid) 

5 Address of first entry > address of tase 
entry 
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SOUND Function Code 69 
Sound Output 


Turns on a single tone (approximately 1 khz) in computers 
that are capable of generating sound. 


Entry Conditions 
A. 69 
HL sound duration (in 1/38th second) 


Exit Conditions 
None 


The sound turns off automatically after n seconds, where: 
n = HL/39 


n may vary slightly, depending on how much disk and video 
access is done while SOUND is on. 
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STCMP Function Code 22 
String Comparison 


Compares two strings to determine their collating sequence. 


Entry Conditions 
A 
(DE) 
(HL) 
BC 


string2 
number of characters to compare 


Exit Conditions 


Z flag = Strings are identical 

NZ = Strings are not identical 

C flag = string 1 (DE) precedes string2 (HL) in the 
collating sequence 

A = first non-matching character (in stringl) 


When the strings are not equal, you can get further 
information from the prime registers, as follows: 


address of the first non-matching character 
in string2 

address of the first non-matching character 
in stringl 

BC? = number of characters remaining 


This includes the non-matching character. 


HL' 


DE ' 
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STSCAN Function Code 49 
String Scan 


Searches through a specified text buffer for the specified 
string. This string can consist of any values §-255 (it is 
not strictly alphanumeric). The scan stops on the found 
string or on the first carriage return encountered, which- 
ever comes first. 


Entry Conditions 
A 49 
(HL) text area to search 


(DE ) compare string 
B length of the compare string 


Exit Conditions 
Z flag = String is found 
NZ = Error; check Register A 
A= @: string is not found 
A # @: error code 
start position of the matching string in 
the search string 


(HL) 
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TIMER Function Code 25 
Set Timer 


Lets you set a "seconds clock" to run at the same time as 
your program and to interrupt the program when time runs 
out. For example, you can specify the number of seconds for 
keyboard input. If input is not made within the time limit, 
TRSDOS-II interrupts the keyboard input routine. It 
interrupts, also, if you reset the timer. 


After the timer counts to zero and causes an interrupt, it 
shuts off by itself. 


See "Programming with TRSDOS-II" for information on 
interrupts. 


Entry Conditions 


A = 25 
(HL) = SVC to handle interrupt 
BC = number of seconds to count down 


If HL and BC both = 9, the timer turns off. If HL = @ and 
BC # §, the time count resets to the value in BC, and 
rr timing continues. 


Exit Conditions 
None 
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Function Code 8 


Outputs a character to the current cursor position. It is a 


scroll mode routine. 


Control codes not listed below are ignored. 


Hex 
Code 


Function 


<CTRL> <D> 
or <F3> 


<CTRL> <G> 


<BACKSPACE> 


<TAB> 


<CTRL> <J> 


<CTRL> <K> 


<ENTER> 


<CTRL> <N> 
or <F/> 


Q7 


£8 


9 


OA 


OB 


OD 


. GE 


Radie Shaek 


Turns on the blinking cursor. 
Turns off the cursor. 


Turns on the steady cursor. 


Sounds bell tone for approximately 
-25 second (in computers that 
generate sound). 


Moves the cursor back one position 
and blanks the character at that 
position. 


Advances the cursor to the next tab 
position. Tab positions are at 
8-character intervals -- 8, 16, 24, 
32, and so on. 


Moves the cursor down to the next 
row, in the same column. 


Moves the cursor to the beginning 
of the previous line. The cursor 
does not move into the 
scroll-protected area. 


Moves the cursor down to the 
beginning of the next line. 


Turns on dual routing. 
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Key Code Function 

<CTRL> <O> OF Turns off dual routing. 

<CTRL> <T> 14 Homes the cursor to the first 
non-scroll-protected position. 

<CTRL> <W> i7 Erases to the end of the line. 
The cursor doesn't move. 

<CTRL> <X> 18 Erases to the end of the screen. 
The cursor doesn't move. 

<CTRL> <Y> 19 Sets the normal display mode 
(green/white on black). Remains 
normal until you reset it. 

<CTRL> <Z> 1A Sets the reverse display mode 
(black on green/white). Remains 
reverse until you reset it. 

<ESC> 1B Erases the screen and homes the 
cursor to Position Q@. 

<left arrow> 1c Moves the cursor back one space. 

<right arrow> 1D Moves the cursor forward one space. 

<up arrow> 1E Sets 8M characters per line and 
clears the display. 

<down arrow> 1F Sets 498 characters per line and 


clears the display. 


Entry Conditions 

A 8 

B ASCII code for the character to be output to 
the display. Character codes must be in the 
range [8,127]. 


Exit Conditions 
NZ = Error 
A = error code 
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VDGRAF Function Code 19 
Video Graphics 


Displays a buffer of characters, starting at the row and 
column you specify. It is a graphics mode routine (the 
cursor "wraps" the display). 


Displayable Characters 


This routine lets you display the 32 graphics characters 
(and their reverse images). 


The codes are numbered from @ through X'1F' and are pictured 
in the operator's manual. Codes X'2@' through X'7F' are 
displayed as standard ASCII characters. 


In addition, several special control codes are available: 


Hex 

Code Result 

F9 Sets the normal (green/white on black) mode. The 
cursor does not move. The mode returns to its 
previous state after the VDGRAF call is completed. 

FA Sets the reverse (black on green/white) mode. The 
cursor does not move. The mode returns to its 
previous state after the VDGRAF call is completed. 

FB Homes the cursor (Row §, Column Q@). 

FC Moves the cursor back one space. Column = Column 
- 1. When the column = 9, the cursor wraps to 
Column 79 on the preceding row. 

FD Moves the cursor forward one space. Column = Column 
+ 1. When the column = 79, cursor the wraps to 
Column @ on the next row. 

FE Moves the cursor up one row. Row = Row - l. When 
the row = @, the cursor wraps to Row 23. 

FF Moves the cursor down one row. Row = Row + l. 


When the row = 23, the cursor wraps to Row §. 


At exit, the cursor always is set automatically to the 
graphics position immediately after the last character 
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displayed. If the buffer length = §, the cursor is set to 
the position specified in Register Pair BC. 


Entry Conditions 


A = 19 
B = row on the screen to start displaying the 
buffer 


B < 24. For B > 23, use B modulo 24* as the row 
position. 

column on the screen to start displaying the 
buffer 

In the 8% characters-per-line mode, C < 8@. For 
C > 79, use C modulo 8% as the column position. 
In the 48 characters-per-line mode, C < 4@. For 
C > 39, use C modulo 4% as the column position. 


buffer length (in range [§,255]) 
beginning of the text buffer 


The buffer should contain codes below X'8@' or 
the special control codes above X'F8'. Any 
value outside these ranges causes an error. 


'? 
It 


7) 
He oil 


(HL) 


Exit Conditions 
NZ = Error (invalid character sent) 
A error code 


*MODULO - A cyclical counting system, in which numberl 
modulo number2 is the integral remainder after division of 
numberl by number2. For example: 35 modulo 24 = ll. 
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VDINIT Function Code 7 
Video Initialization 


Blanks the screen and resets the cursor to the upper left 
corner (Position @ in the scroll mode illustration at the 
beginning of this section). Call VDINIT once before 
starting any I/O to the display. 


Entry Conditions 


A = 7 
B = character size switch 
B= 6: 4@ characters per line 
B # 6: 8 characters per line 
& = normal/reverse switch 


C = @: reverse mode 
C # @: normal mode 


Exit Conditions 
NZ = Error 
A = error code 
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VDLINE Function Code 9 
Video Line 


Writes a buffer of data to the display, starting at the 
current cursor position. The buffer should contain ASCII 
codes in the range [§,127]. 


Control codes that are greater than than X'2f' are ignored. 
(For more information, see VDCHAR. ) 


VDLINE is a scroll mode routine. 


Entry Conditions 
A = 9 
(HL) = beginning of the text buffer 
B = number of characters to be sent 
Cc = end-of-line character 


This character is sent to the display after the 
buffer text. 


Exit Conditions 


NZ = Error 
A = error code 
In case of an error: 
B = number of characters not displayed,including 
the one causing the error 
Cc = character causing the error 


Upon return, the cursor is set automatically to the position. 
following the last character displayed. 
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VDREAD Function Code ll 
Video Read 


Reads characters from the display into the buffer you 
specify. It is a graphics mode routine; when it reads past 
the last column, it wraps back to Column @ on the next row. 
When it reads past Column 79 on Row 23, it wraps back to 
Column 9, Row Q@. 


TRSDOS-II reads reverse (black on green/white) mode 
characters in ASCII codes, just as it does their normal 
counterparts. Reverse mode is indicated when the most 
significant bit (bit 7) is set. 


VDREAD can also be used to locate the cursor (see below). 


Entry Conditions 
A = 11 
B = row on screen where the read starts, B< 24 
If B > 23, use B modulo 24 as the row position. 
he = column on screen where the read starts 
In the 88 characters-per-line mode, C < 8. For 
C > 79, use C modulo 8@ as the column position. 
In the 48 characters-per-line mode, C < 4M. For 
C > 39, use C modulo 48 as the column position. 
D = buffer length (in range [§,255]) 
D= @: return the cursor position 
D # 8: read the display (B = row, C = column) 
(HL) = address of the text buffer 


Exit Conditions 

BC = current cursor position (B = row, C = column) 
The cursor position at exit is the same as at 
entry; VDREAD doesn't change it. 
Error 
error code 


NZ 
A 
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VIDKEY Function Code 12 
Combines VDLINE and KBLINE 


Sends a prompting message to the display and then waits for 
a line from the keyboard. VIDKEY is a scroll mode routine 
which combines the functions of VDLINE and KBLINE. 


Starting at the current cursor position, it displays the 
text buffer you specify. The buffer must contain codes 
less than X'8@'. (See the VDLINE SVC for a list of received 
control codes and other details.) 


Once the text message is displayed, TRSDOS-II positions the 
cursor immediately after the last character displayed. (To 
move it to another position, you must place a control code 
at the end of the text buffer.) 


VIDKEY then uses KBLINE to get a line from the keyboard. 


(See the KBLINE SVC for a list of received control codes and 
other details.) 


Entry Conditions 
A = 12 
B = number of characters to be displayed (in the 
range [@,255]) 


length of the keyboard input field (in the 
range [,255]) 


(HL) = beginning of the text buffer containing 


the display message 


(DE) = beginning of the text buffer where the 


keyboard input is to be stored 


C 


Exit Conditions 


NZ = Error 
A = error code 
If Z is set (no error): 
B = number of characters input from keyboard, 
including carriage return, if any 
C = keyboard line terminator 


C = £: input buffer was filled 
C # @: C contains the control character that 


ended the line (carriage return) 
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If Z is not set (error): 


B = number of characters not displayed, including 


the one causing the error 
Cc = character causing the error 
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VIDRAM Function Code 94 
Transfer Video Display to RAM or Vice-Versa 


Copies a screenful of graphics and/or text from a RAM buffer 
to the video display, or vice-versa. The programmer must be 
aware of the current display mode -- 8@ characters per line 
or 48 characters per line. 


Every possible data byte is treated as a displayable 
character. There are no cursor position or other control 
codes. The following table summarizes the character/code 
relationships for this routine: 


Hex Code Display Character 


@O-1F Normal Graphics 
20-7F Normal ASCII Text 
89-9F Reversed Graphics 
A®-FF Reversed ASCII Text 


Entry Conditions 

A 94 

B function code 
B = §: copy from RAM to video 
B # @: copy from video to RAM 
RAM buffer The start of the buffer must be 
above X'28@@': the end must be below X'FOPD'. 
If the video is in the 8% characters-per-line 
mode, the buffer must be 89 * 24 = 19298 bytes 
Long. 
If the video is in the 48 characters-per-line 
mode, the buffer must be 40 * 24 = 969 bytes 
long. 


(HL) 


Exit Conditions 
None 
(VIDRAM does not change the cursor position.) 
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WILD Function Code 5l 
Wildcard Parser | 


Compares a filespec with a wildcard spec, depending upon the 
contents of B, the function code entry condition. 


A mask is a filespec with asterisk(s) inserted in one or 
more positions in the name or extension. An asterisk means 


"One or more characters -- don't care what they are." For 
example: 
‘ */BAS masks all files except those that have the 


extension /BAS. 


‘ *LST masks all files except those that have a 
filename ending in LST and no extension. 


The filespec is a standard TRSDOS-II filespec, terminated 
by a carriage return. 


For details on wildcard specs, see "Wildcard" in the 
"Introduction." 


Contents 
of B Result 
g | Sets the wildcard mask 
k Compares the filespec with the mask 
2 Combines a separate name and 


extension into a filespec 


Note: Calling any other TRSDOS-II SVC may clear the mask. 
Therefore, you should use this procedure: 


Ls Get the filespec(s) to be checked. 
2% Set the mask by calling WILD with B = Q. 


3% Compare the filespec with the mask by calling WILD 
with B= 1. 


4. Repeat Step 3 until all filespecs have been 
checked. 


Dd. Each time you call another TRSDOS-II SVC, you may 
have to reset the mask. 
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Entry Conditions 


Ww YP 


51 
function switch 


B= @: set the wildcard mask 
B = 1: compare the filespec to the mask 
B = 2: combine into filespec 


wildcard mask 


filespec 


li-byte buffer 

Bytes @-7 = filename; bytes 8-18 = extension 

You must justify both fields on the left, leaving 
trailing Spaces as needed to fill the field. The 
format is: 


The syne % represents a blank space. 


(DE) = 13-byte destination buffer 


This buffer is to hold the compressed filespec 
contained in (HL). 


Exit Conditions 


If B = @: 
NZ 


If B=1: 


Invalid mask specification 


File does not match or you have set no mask 


l3-byte buffer containing filespec 


The filespec is created from the 1l-byte source 
text. 
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WRITNX Function Code 43 
Write Next Record 


Writes the record following the last record accessed. If 
WRITNX is the first access after the file is opened, 
TRSDOS-II writes the first record. 


Before calling WRITNX, put your record in the record area 
pointed to by RECADR in the parameter list. Or, if the 
record length is 256 and the record type is fixed, your 
record is in the area pointed to by BUFADR. 


Entry Conditions 


A = 43 | | 
(DE) = data control block for the currently open file 
HL = Reserved for use in later versions of TRSDOS-II 


Exit Conditions 
NZ Error 
A error code 
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Advance cursor to next 8- 


Carriage return 


Dual routing off. 


Clears screen, homes cursor 


and clears display 


* (BREAK) is always intercepted. It will never return a X’03’. 
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Key- Video Display 
board 
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board Scroll mode Graphics mode 


aii. ad Key- Video Displa 


te 
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Sets black-on-white 
mode 


Moves cursor back 


Moves cursor up 


* Codes 128-248 cannot be input from the keyboard or output to the display. 
When reading the display, a value greater than 127 indicates a reverse 
character corresponding to value mod 128. 
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APPENDIX B / Error Messages 


There are three kinds of error messages you might get while 
using your computer: 


‘ Boot errors, such as BOOT ERROR DC. See the 
Boot Errors Table for more information. 


‘ Operating system errors, such as ERROR 24 or 
FILE NOT FOUND. To get a brief description of a 
numbered error, type ERROR followed by the error 
number displayed. For example, type: 

ERROR 31 <ENTER> 
and your screen shows: 
PROGRAM NOT FOUND 


For more information see the System Errors Table. 


l a’ . Application program errors -- see your application 
program manual. 


When an error message is displayed: 

- Try the operation several times. 

‘ Look up boot errors and operating system errors in 
the following tables and take the recommended 
actions. See your application program manual for 
explanations of application program errors. 

‘ Trying using other diskettes. 

° Reset the computer and try the operation again. 

: Check all the power connections. 


‘ Check all interconnections. 


‘ Remove all diskettes from drives, turn off the 
computer, wait 15 seconds, and turn it on again. 
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If you try all these remedies and continue to get 
an error message, contact a Radio Shack Service 


Center. 


Note: If more than one thing is wrong, the computer might 
wait until you correct the first error before displaying the 
second error message. 


RSSC = Radio Shack Service Center. 
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Numerical System Errors Table 


Register A usually has a return code after any function 


call. 


The Z flag is set when no error occurs. Exceptions 


are certain computational routines, which use Registers A 
and F to pass back data and status information. 


Message 


Explanation/Action 


Bad Function Code 
On SVC Call Or No 
Function Exists. 


Check the function code 
number used on the SVC 
call. 


Character Not 
Available. 


No record or character 
was available when you 
you called the SVC. 


Cail. 


Parameter iS incorrect or 
a required parameter 
is missing. 


1/0. 


Try the operation again, 
using a different 
diskette. If the problem 
occurs often, contact 
RSSC. 


Attempt To Open A 
File Which Has Not 
Been Closed. — 


Close the file before 
re-opening. 


TRSDOS-II detected an 
illegal disk swap. 


Drive door is open or the 
diskette is not in the 
drive. On Thinline 
drives, check the DRIVE 
command settings. 
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Code Message Explanation/Action 

9 Invalid Data Provided Data stream to be 
By Caller. processed has illegal 

characters. 

1g Maximum Of 16 Files Too many files are open 
May Be Open At Once. at once. 

ii File Already In Filename already exists 
Directory. as a directory entry. 


Kill the existing file, 
choose another filename, 
or specify a drive 


number. 
IZ No Drive Available No on-line drive 
For An Open. a. 1S write enabled 


b. has enough space to 
create a new file, or 
c. has a system 


directory. 
i3 Write Attempt To A File was opened for read 
Read Only File. only, not for read/write. 
14 Write Fault On Disk Error occurred during a 
1/0. write operation. Try a 


different diskette. If 
the problem continues, 
contact RSSC. 


15 Disk Is Write Write enable the disk. 
Protected. 

16 DCB Is Modified And DCB (used in machine- 
Is Unusable. language programming) has 


been modified since the 
last disk access (while 
the file was open). 

a Directory Read Error. Error occurred during an 
attempt to read the 
directory. Usea 
different diskette. 
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18 Directory Write Error. Error occurred during an 
attempt to write to the 
directory. Usea 
different diskette. 
19 Improper File Name Filespec you gave does 
(Filespec). not meet TRSDOS-II 
standard file 
specifications. 
20 ** Unknown Error Code ** 
Zi ** Unknown Error Code ** 
22 ** Unknown Error Code ** 
23 ** Unknown Error Code ** 
24 File Not Found. Filename you gave was not 


found on the available 

disks or the file is the 

— «(C incorrect type for the 
desired operation. 


25 File Access Denied You gave an incorrect 
Due To Password password. See 
Protection. the ATTRIB command. 

26 Directory Space Full. Number of filenames 

has reached the amount 


set when you formatted 


the disk. 
27 Disk Space Full. No space is available on 
the disk. 
| 28 Attempt To Read Specified record number 
Past EOF. is past the EOF. 
29 Read Attempt Outside Use valid record numbers. 


Of File Limits. 
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Message 


No More Extents 
Available (16 
Maximum). 


REFERENCE MANUAL 


Explanation/Action 


SS SS SS EE ED ED ED ES SE ES EE GED CEE eeED GD GS GUD ED GE eeu CoE exe cee 
SS DS A OE ES OD RE SS ED EES SERED ED SEED GED GORE GUNES COED CE GOED OOGED GUE GED GS GOED Ee COED 


Use the COPY command to 
copy the files and 

reduce fragmentation. 

See also SAVE/RESTORE and 
MOVE. 


Specified program is not 
found on the available 
disks. 


Unknown Drive Number 
(Filespec). 


Specified drive number 
is not valid. 


Disk Space Allocation 
Cannot Be Made Due To 
Fragmentation Of Space. 


Attempt To Use A 
NON Program File As 
A Program. 


Use the COPY command to 
copy the files and reduce 
fragmentation. 

File specified for 
execution is not a 
program file or the load 
address given is illegal. 
Make sure you have a 
system diskette in 

Drive @. 


Memory Fault During 
Program Load. 


Program is loaded 
incorrectly, possibly 
because of faulty memory 
or a "bad" load address. 


Parameter For Open 
Is Incorrect. 


Check the OPEN statements 
or the DCB for errors. 


Open Attempt For A 
File Already Open. 


File specified for open 
is already open. 


I/O Attempt To An 
Unopen File. 


Open the file before 
access. 
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Explanation/Action 


Illegal I/0 
Attempt. 


a. I command not given 
after a diskette swap. 

b. Can be caused by an 
I/O attempt to a 
differently formatted 
Gdisk. Format the disk 
under the current 
version of TRSDOS-II 
or use FCOPY. 


Seek Error. 


a. Data cannot be read 
from the disk -- 
faulty disk. 

b. When re-initializing a 
hard disk, you must 
also reformat the 
secondary drives. 


Data Lost During Disk 
I/O (Hardware Fault). 


Check the connections, 
power, ribbon, on-line 
status, and So on. 


supply. 


Printer Fault (May Be 
Turned Off). 


Check the connections, 
power, ribbon, on-line 
status, and so on. 


Check the connections, 
power, ribbon, on-line 
status, and so on. 


Not Applicable To 
VLR Type Files. 


Operation performed is 
not valid for VLR files. 


Required Command 
Parameter Not Found. 
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Code Message Explanation/Action 
48 Incorrect Command Option or argument 
Parameter. given in the command is 


incorrect. 


49 Hardware Fault Contact RSSC. 
During Disk I/O. 

59 Invalid Space The space descriptor that 
Descriptor. tells TRSDOS-II which 


extent to read next is 
invalid. Try a different 
diskette. 
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Alphabetical System Errors Table 


Attempt To Open A 
File Which Has Not 
Been Closed. 


Explanation/Action 


Close the file before 
re-opening. 


REFERENCE MANUAL 


EOF se 


Specified record number is 
past the EOF. 


Attempt To Use A 
NON Program File 
As A Program. 


File specified for 

execution is not a program 
file or the load address 
given is illegal. Make sure 
you have a system diskette in 
Drive Q. 


Bad Function Code 
On SVC Call Or No 
Function Exists. 


Check the function code number 
used on the SVC call. 


Invalid Space 
Descriptor. 


The space descriptor that 

tells TRSDOS-II which extent to 
read next is invalid. Try a 
different diskette. 


Character Not 
Available. 


No record or character 
was available when you 
called the SVC. 


CRC Error During 
Disk I/O. 


DCB Is Modified And 
Is Unusable. 


Try the operation again, using 
a different diskette. If the 


problem occurs often, contact RSSC. 


DCB (used in machine- 
language programming) has 
been modified since the last 
disk file access (while 

the file was open). 
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Message Explanation/Action Code 
Data Lost During Disk Contact RSSC. 41 
I/O (Hardware Fault). 

Directory Read Error. Error occurred during an L7 


attempt to read the directory. 
Try a different diskette. 
Number of filenames has reached 26 
the amount set when you 
formatted the diskette. 
Error occurred during an 18 


Error. attempt to write to the 


directory. Use a different 
diskette. 
Disk Drive Not Drive door is open or the ‘8 


diskette is not in the drive. 
On Thinline drives, check the 
Drive command settings. 


Ready. 


Disk Is Write Write enable the disk. LS 

Protected. 

Disk Sector Not Try a different diskette. 5 

Found. 

Disk Space Allocation Use the COPY command to copy 33 

Cannot Be Made Due To the files and reduce 

Fragmentation Of fragmentation. 

Space. 

Disk Space Full. No space is available on the aT 
disk. 

File Access Denied You gave an incorrect password. 25 

Due To Password See ATTRIB command. 

Protection. 

File Already In Filename already exists as 11 


Directory. 


a directory entry. Kill 

the existing file, choose 
another filename, or specify a 
drive number. 
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Message 


Hardware Fault 
During Disk I/O. 


I/O Attempt To An 
Unopen File. 


Illegal I/O 
Attempt. 


Improper File Name 
(Filespec). 


Incorrect Command 
Parameter. 
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Explanation/Actio Code 


Filename you gave was not found 24 
on the available disks or the 

file is the incorrect type for 

the desired operation. 


Contact RSSC. 49 
Open the file before access. 38 
a. I command not given after 39 


a diskette swap. 

b. Can be caused by an I/0 
attempt to a differently 
formatted disk. Format the 
disk under the current version 
of TRSDOS-II or use FCOPY. 


TRSDOS-II detected an illegal 7 
disk swap. 


Filespec you gave does 19 
not meet TRSDOS-II standard 
file specifications. 


Option or argument given 48 
in the command is incorrect. 


Invalid Data Provided Data stream to be processed 9 
By Caller. has illegal characters. 

Maximum Of 16 Files Too many files are open 19 
May Be Open At Once. at once. 

Memory Fault During Program is loaded incorrectly, 35 


possibly because of faulty 
memory or a "bad" load address. 
No Drive Available No on-line drive ie 
For An Open. a. is write enabled 
b. has enough space to create 
a new file, or 
c. has a system directory. 


Program Load. 
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Message Explanation/Action Code 

No Error Found. No error occurred. g 

No More Extents Use the COPY command to copy 39 

Available (16 the files and reduce 

Maximum). fragmentation. See also SAVE/ 
RESTORE and MOVE. 

Not Applicable To Operation performed is not 46 

VLR Type Files. valid for VLR files. 

Open Attempt For A File specified for open 37 

File Already Open. is already open. 

Parameter Error On Parameter is incorrect or a 3 

Call. required parameter is missing. 

Parameter For Open Check the OPEN statements or 36 

Is Incorrect. the DCB for errors. 

Printer Fault (May Check the connections, power, 44 

Be Turned Off). ribbon, on-line status, and so on. 

Printer Not Check the connections, power, 45 

Available. ribbon, on-line status, and so on. 

Printer Not Ready. Check the connections, power, 42 
ribbon, on-line status, and so on. 

Printer Out Of Paper. Check the printer's paper 43 
Supply. 

Program Not Found. Specified program is not found Si 
on available disks. 

Read Attempt Outside Use valid record numbers. 29 


Of File Limits. 


Required Command Required parameter or argument 47 
Parameter Not Found. is missing from the command. 
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a 
Message Explanation/Action Code 
Seek Error. a. Data cannot be read from the 49 
disk -- faulty disk. 
b. When re-initializing a hard 
disk, you must also reformat 
the secondary drives. 
Unknown Drive Number Specified drive number is not 
(Filespec). valid. 
** Unknown Error Codes ** 51-127 
Write attempt to a File was opened for read 13 
read only file. only, not for read/write. 
Write fault on disk Error occurred during a write 14 
EF Oe operation. Try a different 
diskette. If the problem 
continues, contact RSSC. 
f ‘ 
rr, 
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Boot Errors Table 


Message 


Checksum error -- 
possibly a defective 
ROM. 
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Explanation/Action 


chip. 


BOOT ERROR DC 


Floppy disk 

controller error. 

a. Defective 
diskette. 

b. Floppy disk 
expansion unit. 
not on. 

c. Defective FDC 
Chip or Drive. 


Try a different 
diskette. 

Turn on the 
floppy disk 
expansion unit. 
Contact RSSC. 


BOOT ERROR DQ 


Drive not ready. 

a. Improperly 
inserted 
diskette. 

b. Defective 
diskette. 

c. Defective 
drive. 


Insert the 
diskette again 
and press <RESET>. 
Try a different 
diskette. 

Contact RSSC. 


Re-initialize the 
hard disk or contact 
RSSC. 


Controller error. 
Aborted command: 
Problem during 
boot-up of hard 
disk. 


Re-initialize the 
hard disk or contact 
RSSC. 


CRC error. 
Invalid data in 
data field. 
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BOOT ERROR HD Controller error. a. Re-initialize the 

Busy not reset. hard disk. 

b. Power down, wait 
18 seconds, and 
power up. 
If the error occurs 
again, contact RSSC. 
BOOT ERROR HI CRC error. Re-initialize the 

Invalid data in hard disk. 

ID field. 

BOOT ERROR HM Data address Re-initialize the 
mark not found. hard disk. 
BOOT ERROR HN ID not found. Re-initialize the 

No Boot Track. hard disk. 

BOOT ERROR HQ Track @ error 

on hard disk. 

a, Didn‘t find a. Press <RESET>. 
Track @ before 
time-out. 

b. Secondary hard b. Turn on your 
disk drives secondary hard 
not turned on. disk drives. 

BOOT ERROR HT Time-out while 

waiting for Ready. 

a. Hard disk drive a. Follow correct 
not powered up. procedure: 


Turn on the 
hard disk first. 
b. Hard disk drive b. Press <RESET>. 
isn't turned on 
and ready within 
1@ seconds after 
the computer. 
c. Hard disk drive c. Connect the 
is disconnected. hard disk drive 
or operate 
under floppy 
disk control. 
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Message 


Lost data during 
read -- FDC (floppy 
disk controller) or 
drive fault. 


Memory failure in 
address range 
X'1O69O'-X'7FFF'. 


Memory failure in 
address range 
X'8OOO'-X'FFFF'. 


Memory failure in 
address range 


X'OPOO'-X'OFFF'. 


The diskette 

in Drive @ is not 
Radio Shack operating 
system format. 


CRC. HEEOLr, 

Invalid data on 
diskette or defective 
diskette. 


Record not found 
bootstrap track. 
Improperly formatted 


or defective diskette. 
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Explanation/Action 


Try another 
TRSDOS-II diskette 
or contact RSSC. 


Turn on the 
expansion bay if it 
is off. If the 
error occurs again, 
contact RSSC. 


Insert a TRSDOS-II 
formatted diskette 
into Drive @ and 
press <RESET>. 


Try a different 
diskette. 


Re-format your 
diskette or try a 
different diskette. 
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Error Message Explanation/Action 
BOOT ERROR 2Z8 Defective CPU. Contact RSSC. 
NOT A SYSTEM Diskette in Drive Insert a TRSDOS-II 
DISK @ isn't a TRSDOS-II operating system 
operating system diskette into 
diskette. Drive @. 
® 
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APPENDIX C / Alphabetical SVC Quick Reference List 


Name Description No. 

ACTRL —~—~—~«S&erforms control functions on ~—~—~—~—~=«&LCBS 
Channel A 

ARCV Returns a character from Channel A t«éSOC 

ATX Outputs a character to Channel A —t~=«ST 

BCTRL Performs control functions on  ==—~—=s&A id 
Channel B 

BINDEC Converts binary to ASCII-coded—(‘isésdS 
decimal, and vice versa 

BINHEX = Converts binary to ASCII-coded —(‘isés 
hexadecimal, and vice versa 

BRCV Returns a character from Channel B—~—«98 

Bx Outputs a character to Channel Bt~«S 

CLOSE” Terminates access to an open file —«42 

CLRXIT Clears RAM and returns to TRSDOS-II.—S—57 

CURSOR” Turns the blinking cursor on or off —_26 

DATE =—«C«Set's or returns the date and time ~—~—~—45 

DELAY Provides a delay routine 6 

DIRRD Reads the specified record (i (iti‘éSS 


(direct access) 

DIRSET Gets directory information on an 59 
open file 

DIRWR Writes the specified record 44 
(direct access ) 
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Name Description No. 

DOSCMD ~+‘Sends TRSDOS-II a command and then 37 
returns to TRSDOS-II Ready 

ERRMSG Returns an error message to buffer 52 

ERROR +++ Displays "ERROR number" 39 

FILPTR Gets the pointers of an open file § ‘58 

HLDKEY + +‘Suspends and restarts terminal output 29 
whenever you press <HOLD> 

INITIO. ~~—~«sInitializes all input/output drivers g 

jp2008 Returns to TRSDOS-II Ready —(iti‘séC 

KBCHAR dete a character frou the keyboard 4 

KBINIT Clears stored keystrokes $= = |§=& 1 

KBLINE Gets a line fromthe keyboard —i(iti‘éséS 

KBPUT puts a character in the key-ahead 3 
buffer 

KILL ++~+Deletes the file fromthe directory 41 

LOCATE Returns the current record number 333 

LOOKUP Searches through a table #=# #§=§ 28 

MPYDIV Performs multiplication or division 23 
with one 2-byte value and one 1l1-byte 
value 

OPEN. —~—~—~—=CSSet's-up access to a new or existing 48 
file 

PARSER Finds the alphanumeric parameter 46 
field in a text string 

PRCHAR —~—~«SOSends a character to the printer tt 18 

PRCTRL Controls printer operations = = 95 
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Name Description No. 

PRINIT + ‘Initializes the line printer driver «17 

PRLINE Sends aline tothe printer §= 19 

RAMDIR Gets directory information into RAM  —53 

RANDOM brovides a tendon number in the range | 26 
[6,254] 

RDDIR Reads a Wixectorysecoxda = $= . 32 

READNX Sete-the best cacord =0=C*~—“‘“‘“s:s*s*é*s*é~s*S 
(sequential access) 

RENAME mole. |... 

RETCMD +~+~«Sends ‘TRSDOS-II a command anda —(i‘ésB 
return to caller 

REWIND Mwindaa disk file = | 

RS2320 Sete or turns off Channel Aor B for | 35 
serial input/output 

SCROLL +~+~Sets the number of lines at the top of 27 
the display that are not scrolled 

SETBRK Sets up the <BREAK> key processing 33 
program 

SETUSR Seta up a user-defined svC +. 2 

SOUND cana ii . 

SORT. ++~+~+Sortsalist inRAM 56 

SOUND hcottxagivein § 4 

STCMP compares two text etxings  ##§ = . 28 

STSCAN Looks for a specified string inside a 49 


text buffer 
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Name Description No. 

TIMER Sets a timer to interrupt a program 25 

VDCHAR Sends a character to the video 8 
(scroll mode) 

VDGRAF Sends a character to the video 1g 
(graphics mode) 

VDINIT Initializes the display 7 

VDLINE Sends a line to the video ) 
(scroll mode) 

VDREAD Reads characters from the video (scroll Li 
mode ) 

VIDKEY Displays a message and gets a line 2 


from the keyboard 

VIDRAM Copies a screenful of graphics and/or 94 
text from a RAM buffer to the display, 
or vice versa 


WILD Compares a file specification with a 51 
wildcard specification 


WRITNX Writes the next record 43 
(sequential access) 
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APPENDIX D / Numerical SVC Quick Reference List 


No. Name Description 

4. INITIO. Initializes all input/output drivers 

~ KBINIT Clears stored keystrokes —t™*” 

.- SETUSR Sets up a user-defined SVC tt—t™S 

:° SETBRK | Sets up the <BREAK> key processing 
program 

4 KBCHAR Gets a character from the keyboard 

. KBLINE Gets a line from the keyboard 

6. DELAY Provides a delay routine —t™*S 

; Cs VDINIT Initializes the display = 

gs VDCHAR Sends a character to the video (scroll — 
mode ) 

9 VDLINE Sends a line to the video (scroll mode) 

oo VDGRAF Sends a character to the video (graphics 
mode ) 

ve VDREAD Reads characters from the video = 
(graphics mode) 

120” VIDKEY Displays a message and gets a line from 
the keyboard 

is DISKID Reads the diskette ID(s) —™*” 

7 PRINIT Initializes the line printer driver __ 

18 PRCHAR Sends a character to the printer 
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No. Name Description 

19 PRLINE Sends a line to the printer 

20 RANDOM Provides a random number in the range 
[6,254] 

21 BINDEC Converts binary to ASCII-coded decimal, 
and vice versa 

22 STCMP Compares two text strings 

23 MPYDIV Performs multiplication or division with 
one 2-byte value and one l1-byte value 

24 BINHEX Converts binary to ASCII-coded 
hexadecimal, and vice versa 

25 TIMER Sets a timer to interrupt program 

26 CURSOR Turns the blinking cursor on or off 

27 SCROLL sets the number of lines at the top 
of the display that are not scrolled 

28 LOOKUP Searches through a table 

29 HLDKEY Suspends and restarts terminal output 
whenever you press <HOLD> 

39 KBPUT Puts a character into the key-ahead 
buffer 

32 RDDIR Reads a directory record 

33 LOCATE Returns the current record number 

34 READNX Reads the next record (sequential 
access ) 

35 DIRRD Reads the specified record (direct 
access ) 

36 JP2DOS Returns to TRSDOS-II Ready 
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No. Name Description 

37 DOSCMD Sends TRSDOS-II a command and then 
returns to TRSDOS-II Ready 

38 RETCMD Sends TRSDOS-II a command and a return 
to caller 

a9 ERROR Displays "ERROR number" 

49 OPEN Sets up access to a new or existing file 

4l KILL Deletes the file from the directory 

42 CLOSE Terminates access to an open file 

43 WRITNX Writes the next record (sequential 
access) 

44 DIRWR Writes the specified record (direct 
access ) 

45 DATE Sets or returns the date and time 

46 PARSER Finds the alphanumeric parameter field 
in a text string 

47 RENAME Renames a file 

48 REWIND Rewinds a disk file 

49 STSCAN Looks for a specified string inside 
a text buffer 

td WILD Compares a file specification with a 
wildcard specification 

52 ERRMSG Returns an error message to the buffer 

53 RAMDIR Gets directory information into RAM 

55 RS232C Sets or turns off Channel A or B for 


serial input/output 
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No. Name Description 

56 SORT Sorts alist inRAM = 
7 CLRXIT Clears RAM and returns to TRSDOS-II__ 
5 FILPTR Gets the pointers of an open file 
59 DIRSET Gets directory information on an open 

file 

ol SOUND Turns ona single tone 
4 VIDRAM Copies a screenful of graphics and/or 


text from a RAM buffer to the display, 
and vice versa 


95 PRCTRL Controls printer operations 

6 ARCV Returns a character from Channel A 
7 ATX Outputs a character to Channel A 
8 BRCV Returns a character from Channel B 
990 BTX Outputs a character to Channel BS 
ip ACTRL Performs control functions on Channel A 
lo BCTRL Performs control functions on Channel B- 
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APPENDIX E / Summary of the Differences 
between TRSDOS and TRSDOS-II 


Table 1 / General Items 


<Ece CANO UREN CONE) GD HN CNC DS AMES SN SNE ND SD RUD GUND GUNED GUUS UE GOED OUEED UGS SEND GON GND OND GEES SD AEE GRRE GRD CEE GREED GOED SED CGD STENT GED CED AED SEED ED STEED CED SEED GEG GED GOED SEES GEES SEED GEE CED ED ED ee SS Se 
Sean amaan Ginvas Gunaes Cane CRAG COAED CUMS CUTS STL CUA ED SN AMES OOS KEES UN GS ND ND CUE AGED ND SEED LD CUES RED SRMED GES GME SUN GME EGE SND SSNS EGED GE GENE SEED GDS GED SE SED SNEED GEESD SURED SEND CED GEES GEE GED GED Gee CUED comm Game cue conD coe 


Item How TRSDOS-II Differs 

Method of Allocation is done by sectors, instead 
Allocation of by granules. 

Number of Files Variable up to 1228 files, instead of 


fixed at 96. Defaults to 189 for floppy 
diskettes and 336 for hard disks. See 
the FORMAT utility. 


Technique for Flawed areas are locked out by sectors, 
Locking Out Flaws instead of by tracks. 


Reverse Video When in the reverse video mode (black 
Mode characters on green/white background) 
ma and in the scroll mode, the video 


scrolls a green/white line instead of a 
black line. 


Wildcards You can use the symbol ! (exclamation 
point) as a super wildcard symbol. It 
is the same as */* (used for files that 
have extensions) and * (used for files 
that do not have extensions). For 
example: KILL !:3 allows all the user 
files in Drive 3 to be killed. 


SETCOM with You need not execute a SETCOM command 

FORMS before "FORMS S" when using a serial 
printer. However, you still must 
execute SETCOM before sending data to 
the printer. 
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Table 1 (continued) 


New Diagnostic Errors: 


BOOT ERROR CT -- indicates a defective 
CTC chip. Contact your Radio Shack 
Service Center. 


BOOT ERROR MF -- indicates a memory 
failure in address range X'1@@g'- 
X'7FFF'. Contact your Radio Shack 
Service Center. 


BOOT ERROR ML -- indicates a memory 
Failure in address range X'@ggg' - 

X'@FFF'. Contact your Radio Shack 

Service Center. 


New Error: ERROR 59 -- Invalid Space 
Descriptor. The space descriptor that 
tells TRSDOS-II which extent to read 
next is invalid. Try a different 
diskette. 


Errors 28, 21, 22, and 23 are not used. 


BASIC also returns an FL Error (too 
many files). This error was previously 


undefined. 
X'OPOO'-X'27FF' Resident Area 
X'2800'-X'2FFF' Utility Command 
Overlay Area 
X'3000'-X'EFFF' User Area 
X'FOOO'-X'FFFF' TRSDOS-II Demand 
Resident Area 
® 
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Table 2 / Supervisor Calls (SVCs) 


Name How TRSDOS-II Differs Code 

DIRRD Enhanced -- reads the specified 35 
record 

DIRWR Enhanced -- writes the specified 44 
record 

DISKID Enhanced -- reads disk ID 15 

KBPUT New -- puts characters into 39 
a key-ahead keyboard buffer 

LOCATE Enhanced -- returns a record 33 
number 

OPEN Enhanced -- opens/creates 49 
a file 

RDDIR New -- reads the next directory 32 


record and builds an ASCII string 


REWIND New -- rewinds a disk file 48 
to the beginning of the file 


RS232C Enhanced -- initializes Serial 55 
Communication Channels A and B 


SOUND New -- turns on a tone in computers 69 
that are capable of generating sound 


The new SVCs are created specifically for use under 
LTRSDOS<11. 


Note: We recommend restricting your use of the RAMDIR and 
FILPTR SVCsS since each is restricted to 96 files. If you 


are not familiar with these supervisor calls, you should 
change your existing programs to use RDDIR instead. 
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Table 3 / Commands and Utilities 

Name How TRSDOS-II Differs 

ANALYZE No longer available -- cannot be used under 
TRSDOS-II 

BAC KUP Enhanced -- duplicates floppy diskettes 

BUILD Enhanced -- creates an automatic command 
input file 

CLICK New -- Turns the key entry sound on or off 
for those computers that support sound. 

CLOCK No longer available -- cannot be used under 
TRSDOS-II 

DIR Enhanced -- displays a diskette's directory 

DRIVE New -- lets you gain the best use of the 
floppy disk drive by changing the seek rate, 
disk swap detect, and wait for drive ready 
status 

FC New -- edits and repeats the last command 
line entered 

FCOPY New -- transfers files on floppy diskette 
TRSDOS 1.2, 1.2a, 2.8; 2.fa,; or 2.86 to 
a floppy diskette formatted under TRSDOS-II 
(and vice versa except to TRSDOS 1.2 and 
LeZa 

FILES New -- displays an aiphabetical list of 
filenames in a disk's directory. 

FLOPPY New -- tells TRSDOS-II to ignore the 
drive numbers in all file specifications 

FORMAT Enhanced -- formats a disk for data storage 
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Table 3 (continued) 


FREE Enhanced -- displays the number of free 
contiguous sectors and the total amount 
of free space that are on a disk 


HELP Important note only -- gives the proper 
syntax for TRSDOS-II commands 

E Enhanced -- lets you swap diskettes 

LIB Enhanced -- displays the library commands 

RESTORE New -- lets you retrieve the information 


stored in compressed form by SAVE 


SAVE New -- lets you "compress" and store 
information onto diskettes for archive 
purposes 

VERIFY Enhanced -- verifies readable data 

XFERSYS No longer available -- cannot be used under 
TRSDOS-ITI 
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APPENDIX F / More About SAVE and RESTORE 


Backing Up Your Hard Disk 


What would you do if you suddenly lost the data stored on 
your hard disk system? Imagine the time it would take to 
re-enter all the data. 


If, however, you have safe, floppy-diskette copies of the 
data, you would not have to re-enter all the data. You 
could simply restore the data to the hard disk, update the 
information, as needed, and continue. 


Two programs on your hard disk assist you in creating such 
duplicates. 


SAVE -- stores a specified group of files on a 
set of floppy diskettes. These diskettes are ina 
special, compact format that is not directly 
readable from TRSDOS-II. 


In this format, files consume almost half the 
space they normally do on floppy diskettes. SAVE 
also lets you store files (from the hard disk) 
that are normally too large to fit on a floppy 
diskette. 


RESTORE -- lets you retrieve the saved files 
to the hard disk. 


This is the only way to recover saved diskettes. 
Trying to access a saved diskette by using other 
TRSDOS-II commands makes the system appear 

"locked up" for a short time while TRSDOS-II tries 
to read the saved diskette. 


Saving Multiple Diskettes 
Because the hard disk drive is a larger storage system than 
the floppy diskette, you sometimes need to save information 


onto more than one diskette. In such a case, SAVE prompts 
you to insert a new diskette. 
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There are two terms related to SAVE with which you need to 
be familiar: 


‘ Dataset -- A set of one or more diskettes created 
by SAVE. Each dataset has a unique identifier, 
such as 84 4E 56. RESTORE uses the identifier to 
ensure that you do not insert a volume from a 
different dataset. 

‘ Volume -- A diskette that is a member of a 
dataset. TRSDOS-II numbers each dataset's volumes 
in order from Q. 


When you are saving files that require more than one volume, 
TRSDOS-II prompts with: 


Insert NEXT Blank Diskette on Drive n -- 
Press ANY Key to Continue. 


After you do, TRSDOS-II prompts with: 


The Diskette Presently on Drive n 
will be referred to as "VOLUME 1" 


TRSDOS-II saves the files and then prompts: 


Insert "VOLUME §" on Drive n -- 
Press ANY Key to Continue 


TRSDOS-II writes its housekeeping information -- including 
the number of volumes in the dataset -- to Volume Q@. 
RESTORE uses the information to retrieve the files. 
Examples 

There is a variety of ways to use SAVE. The simplest is: 


SAVE 1 TO 2 {ALL} <ENTER> 


This copies all the files from Drive 1 into a compact form 
on the diskette in Drive 2. 


Radie Shaek 


4/38 


TRSDOS-II REFERENCE MANUAL 


TRS-8O0 ° 


Wildcarding 


Wildcards also offer an easy way to save several files or an 
entire disk. For example: 


SAVE */CBL:4 TO @ <ENTER> 


saves all Drive 4 files with the extension /CBL and puts 
them on the diskette in Drive @. 


Using the IND Option 


The indirect option lets you save groups of files by 
creating an indirect file, a file consisting of one or more 
Filespecs (similar to a DO file). You can use the BUILD 
command to create this list of filespecs. 


At TRSDOS-II READY, type: 

BUILD PROGRAMS:@ <ENTER> 
This creates an indirect file called PROGRAMS. 
After TRSDOS-II prompts you with: 


Enter Command Line (1-89) 


Enter your list of file specifications including drive 
numbers, for example: 


ORDERS:5 <ENTER> 
REPORTS/*:6 <ENTER> 


To exit the BUILD and return to TRSDOS-II READY, press 
<BREAK>. 


You are now ready to save the files (specified by the 
indirect file) to the specially formatted floppy diskette. 
Type: 


SAVE PROGRAMS:@ TO 1 {IND} <ENTER> 
Both ORDERS and REPORTS are now found in the file named 


PROGRAMS on the diskette in Drive @ and saved to the 
diskette in Drive l. 
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Note: The IND option lets you save more than one file 
from each hard disk; it also lets you save from more than 
one hard disk. As a result, you might save multiple files 
that have the same name. Because the save and restore 
directory does not specify drive numbers for files, you 
could lose duplicate filenames. 


For example, if you created an indirect file that has these 
files: 


*/FOR: 4 
*/CBL: 4 
*/FOR:5 


Drives 4 and 5 may have duplicate filenames with the /FOR 
extension. Before you use indirect, examine all the files 
to be saved. Rename any duplicate filenames before saving 
or create different datasets. 


Using the DC and DM Options 


Another way to save files is to do so with respect to their 
creation or modification (update) dates. For example, 
Suppose your directory showed these creation and update 
dates for your files: 


Filename Created Updated 
MENU/PRG 6/1/81 9/2/81 

PRGONE/PRG 6/1/81 8/16/81 
PRGTWO/PRG 6/1/81 7/36/81 
PRGTHR/PRG 6/1/81 6/16/81 
PAYROLL/DAT 9/15/81 19/15/81 
CHECKS/DAT 9/15/81 19/15/81 
TEST/PRG 16/29/81 18/29/81 


If you want to save only those files created on June l, 
1981, use the following command: 


SAVE */*:5 TO @ {DC=969181} <ENTER> 


The first four files are saved to the floppy diskette in 
Drive Q@. 
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In the same sense, the first four files were updated on or 
before September 2, 1981 (9/2/81). Type: 


SAVE */PRG:5 TO @ {DM<898281} <ENTER> 


and all files updated on or before the specified date are 
saved. 


How Often Should You Save Your Files? 


How often you should save your files depends upon you and 
how much data you enter. If you enter large amounts of 
data, you should make frequent backups, once or twice a day. 


We suggest you keep two major sets of backup files: 


. Monthly Save Set -- At the first of each month, 
make a save set of the complete hard disk, 
including your programs. 


5 Daily Save Set -- At the end of each day, or at 
most every third day, make a save set of all files 
that have been created or updated since the 
monthly save set was created. 


If your hard disk fails, your monthly save set supplies most 
of your lost data and programs. After you restore this 
information and that from the daily save set, the amount you 
need to re-enter is minimal. 


Creating a Monthly Save Set 


Creating a monthly save set takes time, but it is worth it. 
Have a supply of blank diskettes ready. Do not format them; 
SAVE organizes the diskettes into its own special format. 


Insert a blank diskette into Drive @. At TRSDOS-II Ready, 
type: 


SAVE :4 :@ {SYS,ALL,ABS} <ENTER> 


to save all programs and data files, including system files 
stored on Drive 4, the primary drive. The files are stored 
on diskettes in Drive @. As one diskette becomes full, 
TRSDOS-II prompts you for the next diskette. 
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When all of the files are saved, TRSDOS-II prompts you to 
insert Volume @ (of your monthly save set) into Drive Q@. 
TRSDOS-II now updates that diskette with housekeeping 
information. 


When the save is finished, you are returned to TRSDOS-II 
Ready. Label, number, and date the diskettes. 


Rotating Monthly Save Sets 


The set just created is the current monthly save set. At 
the beginning of the next month, create a new monthly save 
set using different diskettes. This set becomes the current 
set; the other becomes the previous set. 


Rotate these two sets of diskettes when making monthly save 
sets, always usSing the previous set (older) to make the 
current set. 


Creating A Daily Save Set 


When you restore lost information, your daily save sets 
determine how much information you must re-enter. The more 
often you save, the less you re-enter. 


Because the daily save sets are so important, you should 
keep two sets of them: the current daily set and the 
previous daily set. This way, if something happens to the 
current set, you have the previous set to fall back on. 


The simplest way to create a daily save set is to save those 
files created or updated since you created the monthly save 
set. To do this, type: 


SAVE !:4 :@ {DM>mmddyy,ABS,SYS} <ENTER> 


The !:4 specifies all files, with or without extensions. 

The option DM>mmddyy saves all files updated on or after 

the specified date. However, if you keep a monthly save set 
as suggested, this also saves files created after a 
specified date. (The update date and the creation date in 
the directory are the same when the file is created.) 
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For example, if you create a monthly set on January 1, 1983 
(61/01/83), then use the following command to make a daily 
set: 


SAVE !:4 :@ {DM>#19183,ABS,SYS} 
This saves all files created or updated on or after January 


1, 1983 up to the current date. Because the absolute option 
is specified, you are not prompted as each file is saved. 


Rotating Daily Save Sets 
The set just created is the current daily save set. At the 


end of the next working day, create a new daily save set 
using different diskettes. This set becomes the current 


set; the other becomes the previous set. 


Rotate these two sets of diskettes when making daily save 
sets, always using the previous set (older) to make the 
current set. 


Restoring Your Files 


If your hard disk system fails, and you must recover all 
files, follow these steps: 


ae If Drive 4 is not bootable, or the operating 
system is lost, you must re-initialize your 
system, following the instructions given in your 
Hard Disk Owner's Manual. If you are 
sure Drive 4's operating system is not damaged, 
proceed to step 2. 


aa Insert Volume @ of your monthly save set, into 
Drive @ and type: 


RESTORE :@ :4 {ABS,SYS} <ENTER> 


as Insert Volume @ of your daily save set into Drive 
@ and type: 


RESTORE :@ :4 {ABS,SYS} <ENTER> 
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4. Re-enter any information added since the last 
current daily save set was created. 


To restore one file, type the following command: 

RESTORE filespec:9@ :4 {ABS} <ENTER> 
where fFilespec is the name of the file you want restored. 
To restore a group of files, type: 

RESTORE :@ :4 {PROMPT} <ENTER> 


Restore prompts before restoring the files. Answer by 
pressing <Y> or <N> (for "yes" or "no"). 


Always restore files from the last save set available. 


When a Boot Error Occurs on Hard Disk 


If your hard disk system returns a boot error, flip the 
RESET switch on the front of your computer. Then, try to 
start up your system again. If your system continues to 
return a boot error, you probably have lost the boot track, 
Track Q. 


Even when this happens, there is a way to save the contents 


of your primary hard disk. But, to do so, you must have at 
least two floppy disk drives on your system. 


To save the contents of your hard disk system: 


ie Transfer control to the floppy disk system (press 
<BREAK> <REPEAT> during "white-out"). 


i Insert a diskette containing the current floppy 
version of TRSDOS-II in Drive @ and start up the 
system so that you see TRSDOS-II Ready. 


a To be sure there is a chance to save the contents 
of your hard disk, try to get a directory of your 
primary hard disk drive. Type: 


DIR 4 <ENTER> 
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TRS-SO ° 


If you can get a directory, then you probably can 
save the contents of your hard disk. 


4. To save the contents of your primary hard disk 
drive, insert a blank diskette in Drive 1 and 
type: 


SAVE 4 TO 1 {SYS,ALL,ABS} <ENTER> 
oe After the contents of your hard disk are saved, 
re-initialize your primary hard disk drive. (See 
your Hard Disk Owner's Manual for details.) 


6. When the initialization is finished, (in about 15 
to 2@ minutes), you can restore the files that you 
saved. Type: 


RESTORE 1 TO 4 {SYS} <ENTER> 
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REFERENCE MANUAL 


Note: An asterisk is used, when necessary, to designate 
the page(s) on which you will find the entry for the 
particular command, utility, or SVC. 


A 

ABS 2/3 
Access password 174, 

2/7-8 
Access type 3/72-73 
ACTRL SVC 3/31-32 
AGAIN 2/5 
Alternate directory 2757 
APPEND 2/6 
Application program 1/71 
ARCV SVC 3/33-34 
ASCII 2/79 
Assembler 3/29 
ATTRIB 1/43 2/7; 
ATX SVC 3/35-36 
AUTO 2/9%* 
Auto line-feed mode 2/61 


see also FORMS 


B 
Background printing 2/193 
And capture file 


2/193-194 

BACKUP 27/10%, 2767, 371 

Single- to double-sided | 

| 2/711, 

Base 16 it 

BASIC 2/64, 2/69, 3/28 

Baud rate 2/98, 3/199 

BCTRL SVC 3/37-38 

BINDEC 3/39 

BINHEX 3/40 

Boot errors 4/19-22 
Boot error on 


hard disk 4/44 
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Braces iz 273 
BRCV SVC 3/41-42 
Breakpoint 2/26-27 
see also DEBUG 
BTX SVC 3/43-44 
BUILD 2/9, 272%; 
see also DO file 
C 
C flag 3/20). 37 43 
Caps mode 1/2 
Capacity, diskette 3/7-8 
Capture file 2/182 
And background printing 
2/193-194 
changestring 2/75 
Channel 3/199 
Character codes 4/1-4 
Character sizes 3/3;¢375 
Characters per line 2/69 
see also FORMS 
CLEAR 2/16*, 2/69 
CLICK 2/17 
CLOSE SVC 3/45 
CLRXIT SVC 3/46 
CLS 2/18 
Column 3/4 
Command Lg! 27a 


Differences between 
TRSDOS and TRSDOS-II 


4/35-36 

Entering a command L72 
Command file 2/9 
Command string 3/54 
Command syntax 2/2-3 
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comment ie 273 DIRWR SVC 
Comment block 3/22, 3/724 (Direct Write) 3/13-14, 
COPY 2/19-28*, 3/1, 3/9 3/26, 3/752* 
CREATE 2/21-22* Disk ii 
Creation code 3/73-74 Disk files iyo 
Creation date 2/93, 2/96 Disk I/O 
CURSOR SVC 3/47 (disk name) ig 1/5 
Cylinders 2758 Disk organization 3/7-8 
Disk sectors 3/7, 3/18 
D Diskette i 
Data control block 3/78 Diskette capacity 3/7-8 
Data files 27 33 Double-sided diskette 3/7 
Dataset 4/38 Single-sided 
DATE 2/23 diskette 3/7-8 
DATE SVC 3/48 Diskette space 
Date created 2732; allocation ay 7 
2/93, 2/96 Double-sided 
Date modified 27 33 diskette 3/7 
2/93, 2/96 Single-sided 
DEBUG 2/24-31%*, diskette a7 7 
2/35, 2/69 Diskette swap 2/67 
Command description DISKID SVC 3/53 
2/26-39 DO 2/9, 2/35-36%, 
Entering DEBUG from 2769; 3728, 3739 
BASIC 2/24 see also BUILD 
Entering the debug Do file 2/6, 2712-15; 
monitor 2/25-26 2/79 
Setting breakpoints Creating 2/12-13 
2/26-27 Editing 2/13-15 
Z-88 Register DOSCMD SVC 3/54 
Contents & RAM Double-sided diskette 3/7 
Display 2725 :drive ix 7/5 
Decimal number ii DRIVE 2/37-43* 
DELAY SVC 3/48 Drive heads 2757 
Delimiter i Drive settings 2/37-42 
DIR L/Ty 2/7/32=34*, DETECT 2737 
2/54, 3758 NODETECT 2/37 
Direct file access 3/13-14 NOWAIT 2/38 
Directory 1/3 OFFLINE 2/38, 2/41-42 
Alternate directory 2/57 ONLINE 2/38 
Primary directory 2/57 RATE 2737 
DIRRD SVC WAIT 2/38 
(Direct Read) 3/13-14, Drive types (floppy) 2/39 
3/59 DUAL 2/44 
DIRSET SVC 3/51 


TRSDOS-II REFERENCE MANUAL 
TRS-80 
Dummy modes 2/61 FILES L/7 2754" 
DUMP 2/45-46 Files, number of 4/31 
Dump address 2/45 filespec i; 173-6 
FILPTR SVC 3/57 
E findstrin 
ECHO 2/47 2/75 
End list marker 3/191 First-in, first-out buffer 
End of file (EOF) 3713, (FIFO) 3/33, 3/741 
3/15 4% 3/237 Fixed-length record (FLR) 
3750, 3752 97/6; DJ2ly 2/7 Tae B/ily 
ERRMSG 3/755 3/14,. 3725, 3767» 3774 
ERROR 2/48 FLOPPY 2/51, 2/55* 
ERROR (SVC) 3/56 Floppy diskette 
Error messages 4/5-22, see Diskette 
4/32 FORMAT 2/56-59*, 2/67 
/ext (extension) When to format 2/59 
i, 1/3-4 FORMS 2/68-61 
Changing an Format options 2/69 
extension 2/88, 3/97 Printer parameters 2/69 
Combining a filename Switch options 2/61 
and extension 3/121 FREE 2/62 
Extents 2/62 Free-space list 
format 3/92 
F Function code 3/18 
FC 2/49-5G 
FCOPY l/ 7%: 275% G 
2/51-53*, 2/67 Graphics mode 3/3-4 
Used to display 
a directory 2/52 H 
Field 3/76 Hard disk i 
File access Hard disk drives 
Direct 3/13-14 HELP 2/64 
Sequential 3/13-14 Hexadecimal number 17 
File allocation 2/21.; 3/9 High-memory modules 
De-allocation 2721. 379 3/28-39 
Dynamic allocation 2/21, HLDKEY SVC 3/58 
3/9 <HOLD> 3/58 
Pre-allocation Zi 2i. HOST 2/65-66, 3/28, 3/29 
3/9 
filename Ly SS Zz 
Renaming a file ca 2/67 
2/88, 3/97 Indexed access files 
Combining a filename (ISAM) 2/6 
and extension 3/121 Indirect file 2/91-92, 


Number in directory 2/57 
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INITIO 3/59 Modification date 2/93, 
Input/output drivers 2/16 2/96 
Interactive terminal Modulo 3/113 
mode 2/187, 2/189-119 MOVE 1/7, 2/73-74% 
Interleave factor 2/57-58 MPYDIV SVC 3/69 
Interrupts 
see Programming N 
a Normal mode 2/61 
J Notations ii 
JP2DOS SVC 3/68 
O 
K OPEN SVC 3/69-73 
KBCHAR SVC 3/61 Data control block 3/79 
KBINIT SVC 3/62 Parameter list 3/71-74 
KBLINE SVC 3/63-64 Operating system 
KBPUT SVC 3/65 Loading TRSDOS-II E71 
Key entry sound oF ae IRF TRSDOS-II command 
Key-ahead 1/2 level 1/1 
Key-ahead buffer 3/61-62 {options} | 
KILL 1/7, 2/68* 
KILL SVC 3/66 P 
Parameter i, 2/2 
L Errors 
Latch drive . epee List address 
Length byte 3/11-12 Parity 1/98, 3/191 
LIB 2/1, 2/69* PARSER SVC 3/75-89 
Lines per page 2/69 Repetitive uses 3/89 
Linker 3/29 . password i, 1/3-4 
LIST 2/78*, 2/77, Access password Lf as 
2/88, 3/58 2/7-8 
List address Assigning Zi 22 
block 3/77-79 Changing the 
LOAD 2/71: protection 2/81 
LOCATE SVC 3/14;- 3/67* Protection level 2/7 
LOOKUP SVC 3/68 Update password L/4, 
Logical record 3/9 2/7-8 
Logical record length 3/72 PASSWORD 2/20 
PATCH 2/75-78 
M Data files 2/77 
Memory requirements TRSDOS-II system files 
3/1-2, 4/32 2/76 
MEMTEST 2/72 Z-88 program files 
Menu mode ' 2/1897, 2/199 2/76-77 
Modem 2/197 patch string 2/78 


Radie Shaek 


TRSDOS-II me REFERENCE MANUAL 
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PAUSE 2/79 RECEIVE 2/83-87 

PRCTRL SVC 3/83-86 Loading address 2/83 

Physical record 3/9 Required data format 


Power-up diagnostics 4/32 


(Intel hex format) 2/84 


Pre-allocation 2721.,°-379 Record 3/19 
PRCHAR SVC 3/81-81 Record length 3/95 3/72 
Primary directory 2/57 Record numbers 3/13 
Primary drive Ly fe Record processing 3/13-15 
PRINIT SVC 3/87-88 RENAME 2/88 
PRINT SVC 2/89 RESET 2/89 
Print file 2/192 RESTORE 2/67, 2/98-92*, 
Printed lines per page 2/69 4/43-44 
Printer control codes 2/61 RET instruction 3/22 
Printer driver RETCMD SVC 3/98*, 3/193 
Parallel 2/61 Reverse video mode 4/31 
Serial Channel B 2/61 RL (record length) 3/72 
Printer output 2/192-193 Row 3/4 
PRLINE SVC 3/89 RS2Z32C SVC 3/25 
Program 3/199-191* 
Executing a program 1/2 RST @ 3/69 
Program files 2/33 RST 8 3/18-19 
Writing program files SAVE 2/67, 2/93-96% 
3/25-27 Indirect files 2/94-95 

Program data Multiple 
blocks 3/22 3/723 diskettes 4/37-38 
Program entry Wildcarding 2/94 
conditions 3/29-21 Save set 4/41-43 
Programming with user SCREEN 2/97 
interrupts 3/29-21 SCROLL SVC 3/6, 3/192 
Prompt Scroll 3/5 
PROT 2/81 Scroll mode 3/5-6 
Protection level 2/7 Scroll window 2/24 
Push-Button 2/39 Sector S77 S710 
PURGE 2/82 Free sectors 2/62 
Separator 3/76 

R Sequential file 
RAM (random access access 3/13-14 
memory ) i Sequential read 3/14 
RAM buffer i Sequential write 3/14 
RAMDIR SVC 3/57. 3/98 SETBRK SVC 3/21, 3/193* 
RANDOM SVC 3/93 SETCOM SVC 2/61, 
RDDIR SVC 3/514 2/575 2/98-18 9%, 
3/98, 3/94-95* 3/19, 4/31 
READNX SVC 3/14, 3/96* SETUSR SVC 3/18, 3/194* 
® 
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TRS-SO * 
Single-sided U 
diskette 3/7-8 Update password 1/4, 2/7-8 
SOUND SVC 3/196 User file 2/33 
SORT SVC 3/195 User memory 2/iy 2716 
Spanning 3/19, 3/26 User record 3/9 
SPOOL 2/35, 2/191-194* User vector 3/194 
/28, 3/29-38, 3/49 UE Ite 2/ 1% 4/35-36 
STATUS SVC 2/195 
STCMP SVC 3/197 V 
Stop bits 2/99, 3/191 Variable-length 
STSCAN SVC 3/198 recotd (VLR) .2/6,;, 2/21, 
Supervisor calls (SVCSs) 3/11, 3/14=-18; 3/771 
Block 3/22-25 VDCHAR SVC 3/119-111 
Calling procedure VDGRAF SVC 3/112-113 
3/18-19 VDINIT SVC 3/114 
Initialization 3/19 VDLINE SVC 3/115 
Input/output 3/19-29 VDREAD SVC 3/116 
Quick reference list Vectors 3/194 
4/23-3 VERIFY 2/125 
Serial communications Verification level 2757 
SVCs 3/29-29 Video display 3/3-6 
Swap diskettes 2/67 VIDKEY SVC 3/117-118 
Syntax 2/2-3 VIDRAM SVC 3/119 
System files 2733 Volume 4/38 
T WwW 
T 2/196 WILD SVC 3/129-121 
TERMINAL 2/64, 2/69, Wildcards 1/6-7 
2/197-123 Wildcard (*) 1/6 
Error conditions 271.23 Super wildcard (!) Ls 7 
Terminator 3/76 Wildcard mask 
Terms i-ii Set B71 
Thinline 2/39 Compare to filespec 
TIME 2/124 37121. 
TIMER SVC 3/21, 3/199* Word length 2/98, 3/191 
Top of form 2/61, 2/196 Write precompensation 
Track 3/7 2/58 
Trailer block 3/23% 3/725 WRITNX SVC 3/14, 3/122 
Transfer address 2/45 
Transparent mode 2/61 Z 
Transmit from RAM mode Z-8% program file 3/28, 
2/187, 2/11@-111 3/22-27 
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